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 |
| Header | wdfresource.h (Wdf.h を含む) |
| Library | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |