[KMDF にのみ適用]
WdfPdoUpdateAddressDescription メソッドは、指定されたフレームワーク デバイス オブジェクトに関連付けられている アドレスの説明 を更新します。
構文
NTSTATUS WdfPdoUpdateAddressDescription(
[in] WDFDEVICE Device,
[in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);
パラメーター
[in] Device
デバイスの物理デバイス オブジェクト (PDO) を表すフレームワーク デバイス オブジェクトへのハンドル。
[in, out] AddressDescription
アドレスの説明を含む呼び出し元によって割り当てられたバッファーへのポインター。 アドレスの説明には、WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 構造体が含まれている必要があります。
戻り値
操作が成功した場合、関数はSTATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
デバイス ハンドルは PDO を表していません。 |
|
Device ハンドルは、動的に列挙された されたデバイスを表しません。また、指定された WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 構造体の Size メンバーが、デバイスの既存のアドレス記述のサイズと一致しない場合。 |
このメソッドは、他の NTSTATUS 値返す場合もあります。
ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfpdo.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |