WdfIoResourceRequirementsListInsertIoResList 函式 (wdfresource.h)

[僅適用於 KMDF]

WdfIoResourceRequirementsListInsertIoResList 方法會將邏輯組態插入資源需求清單中。

語法

NTSTATUS WdfIoResourceRequirementsListInsertIoResList(
  [in] WDFIORESREQLIST RequirementsList,
  [in] WDFIORESLIST    IoResList,
  [in] ULONG           Index
);

參數

[in] RequirementsList

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

[in] IoResList

架構 resource-range-list 物件的句柄，代表裝置硬體資源的邏輯設定。

[in] Index

以零起始的值，用來做為一組已在 RequirementsList 所指定資源需求清單中之邏輯組態的索引。 若要將組態新增至清單結尾，請指定WDF_INSERT_AT_END或 WdfIoResourceRequirementsListGetCount 的傳回值。

傳回值

如果作業成功，WdfIoResourceRequirementsListInsertIoResList 會傳回STATUS_SUCCESS。 否則，這個方法可能會傳回下列其中一個值：

傳回碼	Description
STATUS_INVALID_PARAMETER	指定的無效參數。
STATUS_INVALID_DEVICE_REQUEST	指定的 resource-requirements-list 物件不會擁有指定的 resource-range-list 物件。
STATUS_INSUFFICIENT_RESOURCES	架構無法配置空間來儲存 resource-range-list 物件。
STATUS_ARRAY_BOUNDS_EXCEEDED	Index 參數的指定值太大。

 

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

備註

WdfIoResourceRequirementsListInsertIoResList 方法會將 IoResList 參數指定的邏輯組態插入 RequirementsList 參數所指定的資源需求列表中，在 Index 值識別的邏輯設定前面。

若要將邏輯組態新增至資源需求清單的結尾，請使用 WDF_INSERT_AT_END 或 WdfIoResourceRequirementsListGetCount 的傳回值作為 Index 值。 或者，使用 WdfIoResourceRequirementsListAppendIoResList 方法。

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

範例

下列程式代碼範例示範 EvtDeviceResourceRequirementsQuery 回 呼函式如何建立兩個空的邏輯組態，並將其新增至資源需求清單。

NTSTATUS
Example_EvtDeviceResourceRequirementsQuery(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
    NTSTATUS  status;
    WDFIORESLIST  logConfig1;
    WDFIORESLIST  logConfig2;

    status = WdfIoResourceListCreate(
                                     RequirementsList,
                                     WDF_NO_OBJECT_ATTRIBUTES,
                                     &logConfig1
                                     );
    if (!NT_SUCCESS(status)) {
        return status;
    }

    status = WdfIoResourceRequirementsListAppendIoResList(
                                             RequirementsList,
                                             logConfig1
                                             );
    if (!NT_SUCCESS(status)) {
        return status;
    }

    status = WdfIoResourceListCreate(
                                     RequirementsList,
                                     WDF_NO_OBJECT_ATTRIBUTES,
                                     &logConfig2
                                     );
    if (!NT_SUCCESS(status)) {
        return status;
    }
    status = WdfIoResourceRequirementsListInsertIoResList(
                                             RequirementsList,
                                             logConfig2,
                                             WDF_INSERT_AT_END
                                             );
    if (!NT_SUCCESS(status)) {
        return status;
    }
...
}

規格需求

需求	值
目標平台	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)

另請參閱

WdfIoResourceListCreate

WdfIoResourceRequirementsListAppendIoResList