WdfCmResourceListGetDescriptor 関数 (wdfresource.h)
[KMDF と UMDF に適用]
WdfCmResourceListGetDescriptor メソッドは、指定したリソース リストに含まれているリソース記述子へのポインターを返します。
構文
PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
パラメーター
[in] List
デバイスのハードウェア リソースの一覧を表すフレームワーク リソースリスト オブジェクトへのハンドル。
[in] Index
List が指定する論理構成のインデックスとして使用される 0 から始まる値。
戻り値
WdfCmResourceListGetDescriptor は、インデックス値が有効な場合、Index パラメーターが識別するハードウェア リソースを記述する CM_PARTIAL_RESOURCE_DESCRIPTOR 構造体へのポインターを返します。 それ以外の場合、メソッドは NULL 返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。
備考
ドライバーは、WdfCmResourceListGetDescriptor 取得 リソース記述子を変更できません。
リソース 一覧の詳細については、「Framework-Based ドライバー のハードウェア リソースの」を参照してください。
例
WdfCmResourceListGetDescriptor 使用するコード例については、「WdfCmResourceListGetCountを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.0 |
| UMDF の最小バージョン を する | 2.0 |
| ヘッダー | wdfresource.h (Wdf.h を含む) |
| ライブラリ | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |