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
                                        );
...
}

規格需求

另請參閱

WdfIoResourceRequirementsListRemoveByIoResList