WdfIoResourceListGetDescriptor 関数 (wdfresource.h)
[KMDF にのみ適用]
WdfIoResourceListGetDescriptor メソッドは、リソース要件リストの論理構成に含まれているリソース記述子へのポインターを返します。
構文
PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
パラメーター
[in] ResourceList
デバイスのハードウェア リソースの論理構成を表すフレームワーク リソース範囲リスト オブジェクトへのハンドル。
[in] Index
ResourceList が指定する論理構成のインデックスとして使用される 0 から始まる値。
戻り値
WdfIoResourceListGetDescriptor は、インデックス値が有効な場合に Index パラメーターが識別するハードウェア リソースを記述するIO_RESOURCE_DESCRIPTOR構造体へのポインターを返します。 それ以外の場合、メソッドは NULL を返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。
注釈
ドライバーは、WdfIoResourceListGetDescriptor が取得するIO_RESOURCE_DESCRIPTOR構造体の内容を変更できません。 リソース記述子を変更するために、ドライバーは WdfIoResourceListUpdateDescriptor を呼び出すことができます。
リソース要件リストと論理構成の詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。
例
WdfIoResourceListGetDescriptor を使用するコード例については、「WdfIoResourceRequirementsListGetIoResList」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfresource.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |