WdfIoResourceRequirementsListRemove 函式 (wdfresource.h)

  • 發行項

[僅適用於 KMDF]

WdfIoResourceRequirementsListRemove 方法會從資源需求清單中移除邏輯組態。

語法

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

參數

[in] RequirementsList

架構 resource-requirements-list 物件的句柄，代表裝置的資源需求清單。

[in] Index

以零起始的值，做為 RequirementsList 所指定之資源需求清單中的索引。

傳回值

無

備註

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

WdfIoResourceRequirementsListRemove 方法會移除與 Index 參數指定之索引值相關聯的邏輯組態。

當 WdfIoResourceRequirementsListRemove 移除具有索引值 n 的邏輯組態時，下一個邏輯組態的索引值會從 n+1 變更為 n。

如需資源需求清單的詳細資訊，請參閱 Framework-Based 驅動程式的硬體資源。

範例

下列程式代碼範例會從資源需求清單中移除第二個邏輯組態。

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

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfresource.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

WdfIoResourceRequirementsListRemoveByIoResList