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)

こちらもご覧ください

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor