WdfIoResourceRequirementsListGetIoResList 関数 (wdfresource.h)
[KMDF にのみ適用]
WdfIoResourceRequirementsListGetIoResList メソッドは、指定されたリソース要件リスト内の指定された論理構成を表すフレームワーク resource-range-list オブジェクトへのハンドルを返します。
構文
WDFIORESLIST WdfIoResourceRequirementsListGetIoResList(
[in] WDFIORESREQLIST RequirementsList,
[in] ULONG Index
);
パラメーター
[in] RequirementsList
デバイスのリソース要件リストを表すフレームワーク resource-requirements-list オブジェクトへのハンドル。
[in] Index
RequirementsList が指定するリソース要件リストのインデックスとして使用される 0 から始まる値。
戻り値
WdfIoResourceRequirementsListGetIoResList は、インデックス値が有効な場合に Index パラメーターが識別する論理構成を表すフレームワーク resource-range-list オブジェクトへのハンドルを返します。 それ以外の場合、メソッドは NULL を返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。
注釈
リソース要件リストの詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。
次のコード例では、デバイスのリソース要件リストを検索して、割り込みリソースを記述する最初のリソース記述子を検索します。
NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
IN WDFDEVICE Device,
IN WDFIORESREQLIST RequirementsList
)
{
ULONG i, j, reqCount, resCount;
BOOLEAN descriptorFound = FALSE;
//
// Obtain the number of logical configurations.
//
reqCount = WdfIoResourceRequirementsListGetCount(RequirementsList);
//
// Search each logical configuration.
//
for (i = 0; i < reqCount; i++) {
WDFIORESLIST reslist;
if (descriptorFound) {
break;
}
reslist = WdfIoResourceRequirementsListGetIoResList(
RequirementsList,
i
);
//
// Get the number of resource descriptors that
// are in this logical configuration.
//
resCount = WdfIoResourceListGetCount(reslist);
for (j = 0; j < resCount; j++) {
PIO_RESOURCE_DESCRIPTOR descriptor;
//
// Get the next resource descriptor.
//
descriptor = WdfIoResourceListGetDescriptor(
reslist,
j
);
//
// Stop if this descriptor is an interrupt descriptor.
//
if (descriptor->Type == CmResourceTypeInterrupt) {
descriptorFound = TRUE;
break;
}
}
}
...
}
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.0 |
Header | wdfresource.h (Wdf.h を含む) |
Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
IRQL | <=DISPATCH_LEVEL |
DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |