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
ヘッダー	wdfresource.h (Wdf.h を含む)
ライブラリ	Wdf01000.sys (フレームワークライブラリのバージョン管理を参照)。
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則をする	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)