WdfPdoRetrieveIdentificationDescription 関数 (wdfpdo.h)

  • [アーティクル]

[KMDF にのみ適用]

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

構文

NTSTATUS WdfPdoRetrieveIdentificationDescription(
  [in]      WDFDEVICE                                    Device,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

パラメーター

[in] Device

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

[in, out] IdentificationDescription

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

戻り値

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

リターン コード 説明
STATUS_INVALID_PARAMETER
 デバイス ハンドルは PDO を表しません。
STATUS_INVALID_DEVICE_REQUEST
 デバイス ハンドルは、動的に列挙されたデバイスを表していないか、WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER構造体に正しいバッファー サイズが含まれていない場合は表しません。
 

メソッドは、他の 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_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription