共用方式為

WdfIoResourceRequirementsListInsertIoResList 函式 （wdfresource.h）

  • 發行項

[僅適用於 KMDF]

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

語法

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

參數

[in] RequirementsList

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

[in] IoResList

架構資源範圍清單物件的句柄，代表裝置硬體資源的邏輯組態。

[in] Index

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

傳回值

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

傳回碼 描述
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 或來自 WdfIoResourceRequirementsListGet Count 的傳回值作為 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;
    }
...
}

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標頭 wdfresource.h （包括 Wdf.h）
連結庫 Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另請參閱

WdfIoResourceListCreate

WdfIoResourceRequirementsListAppendIoResList