WdfIoResourceRequirementsListAppendIoResList 函式 (wdfresource.h)

  • 發行項

[僅適用於 KMDF]

WdfIoResourceRequirementsListAppendIoResList 方法會將邏輯設定新增至資源需求清單的結尾。

語法

NTSTATUS WdfIoResourceRequirementsListAppendIoResList(
  [in] WDFIORESREQLIST RequirementsList,
  [in] WDFIORESLIST    IoResList
);

參數

[in] RequirementsList

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

[in] IoResList

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

傳回值

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

傳回碼 Description
STATUS_INVALID_PARAMETER
 指定了無效的參數。
STATUS_INVALID_DEVICE_REQUEST
 指定的 resource-requirements-list 對象沒有指定的 resource-range-list 物件。
STATUS_INSUFFICIENT_RESOURCES
 架構無法配置空間來儲存資源範圍清單物件。
 

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

備註

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

範例

下列程式代碼範例示範 EvtDeviceResourceRequirementsQuery 回呼函式如何建立空的邏輯設定，並將它附加至資源需求清單。

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

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

    status = WdfIoResourceRequirementsListAppendIoResList(
                                             RequirementsList,
                                             logConfig
                                             );
    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

WdfIoResourceRequirementsListInsertIoResList