WdfIoResourceListRemove 関数 (wdfresource.h)

[KMDF にのみ適用]

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

構文

void WdfIoResourceListRemove(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

パラメーター

[in] ResourceList

デバイスのハードウェア リソースの論理構成を表すフレームワーク リソース範囲リスト オブジェクトへのハンドル。

[in] Index

ResourceList が指定する論理構成のインデックスとして使用される 0 から始まる値。

戻り値

なし

解説

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

WdfIoResourceListRemove メソッドは、Index パラメーターが指定するインデックス値に関連付けられているリソース記述子を削除します。

WdfIoResourceListRemove がインデックス値 n を持つリソース記述子を削除すると、次のリソース記述子のインデックス値が n+1 から n に変わります

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

次のコード例では、論理構成から最初のリソース記述子を削除します。

WdfIoResourceListRemove(
                        Reslist,
                        0
                        );

要件

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

こちらもご覧ください

WdfIoResourceListRemoveByDescriptor