WdfIoResourceRequirementsListRemove 関数 (wdfresource.h)

[KMDF にのみ適用]

WdfIoResourceRequirementsListRemove メソッドは、リソース要件リストから論理構成を削除します。

構文

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

パラメーター

[in] RequirementsList

デバイスのリソース要件リストを表すフレームワーク リソース要件リスト オブジェクトへのハンドル。

[in] Index

RequirementsList が指定するリソース要件リストのインデックスとして使用される 0 から始まる値。

戻り値

なし

解説

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

WdfIoResourceRequirementsListRemove メソッドは、Index パラメーターが指定するインデックス値に関連付けられている論理構成を削除します。

WdfIoResourceRequirementsListRemove がインデックス値 n を持つ論理構成を削除すると、次の論理構成のインデックス値が n+1 から n に変わります。

リソース要件の一覧の詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。

例

次のコード例では、リソース要件リストから 2 番目の論理構成を削除します。

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
Header	wdfresource.h (Wdf.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WdfIoResourceRequirementsListRemoveByIoResList