WdfIoResourceRequirementsListRemoveByIoResList 関数 (wdfresource.h)
[KMDF にのみ適用]
WdfIoResourceRequirementsListRemoveByIoResList メソッドは、リソース要件リストから 論理構成 を削除します。
void WdfIoResourceRequirementsListRemoveByIoResList(
[in] WDFIORESREQLIST RequirementsList,
[in] WDFIORESLIST IoResList
);
[in] RequirementsList
デバイスのリソース要件リストを表すフレームワーク リソース要件リスト オブジェクトへのハンドル。
[in] IoResList
RequirementsList が指定するリソース要件リストから削除する論理構成を表すフレームワーク リソース範囲リスト オブジェクト ハンドル。
何一つ
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
WdfIoResourceRequirementsListRemoveByIoResList メソッドは、IoResList パラメーターが指定するハンドルに関連付けられている論理構成を削除します。
WdfIoResourceRequirementsListRemoveByIoResList が n インデックス値を持つ論理構成を削除すると、次の論理構成のインデックス値が n+1 から nに変わります。
リソース要件の一覧の詳細については、「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 the port descriptor
// that we're looking for.
//
if (descriptor->Type == CmResourceTypePort) {
if ((descriptor->u.Port.MinimumAddress) == PORT_RANGE_A) {
WdfIoResourceRequirementsListRemoveByIoResList(
RequirementsList,
reslist
);
descriptorFound = TRUE;
break;
}
}
}
...
}
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | 万国 |
最小 KMDF バージョン | 1.0 |
ヘッダー | wdfresource.h (Wdf.h を含む) |
ライブラリ | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
IRQL | <=DISPATCH_LEVEL |
DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
WdfIoResourceListGetCount を する
WdfIoResourceListGetDescriptor の
WdfIoResourceRequirementsListGetCount