WdfPdoRetrieveAddressDescription 関数 (wdfpdo.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfPdoRetrieveAddressDescription メソッドは、指定されたフレームワーク デバイス オブジェクトに関連付けられているアドレスの説明を取得します。

構文

NTSTATUS WdfPdoRetrieveAddressDescription(
  [in]      WDFDEVICE                             Device,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);

パラメーター

[in] Device

デバイスの物理デバイス オブジェクト (PDO) を表すフレームワーク デバイス オブジェクトへのハンドル。

[in, out] AddressDescription

アドレスの説明を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 アドレスの説明には 、WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 構造体が含まれている必要があります。

戻り値

操作が成功した場合、関数はSTATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

リターン コード 説明
STATUS_INVALID_PARAMETER
 デバイス ハンドルは PDO を表しません。
STATUS_INVALID_DEVICE_REQUEST
 デバイス ハンドルは、動的に列挙されたデバイスを表しません。
 

メソッドは、他の NTSTATUS 値も返す場合があります。

ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfpdo.h (Wdf.h を含む)
Library Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription