[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を返します。 その他の戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
デバイス ハンドルは PDO を表していません。 |
|
Device ハンドルは、動的に列挙された されたデバイスを表していません。また、WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 構造体に適切なバッファー サイズが含まれていない場合も同様です。 |
このメソッドは、他の NTSTATUS 値返す場合もあります。
ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfpdo.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |