共用方式為

WdfIoResourceListCreate 函式 (wdfresource.h)

  • 發行項

[僅適用於 KMDF]

WdfIoResourceListCreate 方法會建立空的邏輯組態，可以填入並新增至資源需求清單。

語法

NTSTATUS WdfIoResourceListCreate(
  [in]           WDFIORESREQLIST        RequirementsList,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFIORESLIST           *ResourceList
);

參數

[in] RequirementsList

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

[in, optional] Attributes

呼叫端配置的 WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新 對象的屬性。 (結構的 ParentObject 成員必須是 NULL。) 此參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[out] ResourceList

架構 resource-range-list 物件的句柄，代表新的邏輯組態。

傳回值

如果作業成功，WdfIoResourceListCreate 會傳回STATUS_SUCCESS。

如需其他傳回值，請參閱 Framework 物件建立錯誤。

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

備註

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

呼叫端指定的 resource-requirements-list 物件會成為新 resource-range-list 物件的父代。 驅動程式無法變更此父代， 而且 ParentObject 成員或 WDF_OBJECT_ATTRIBUTES 結構必須是 NULL。

範例

如需使用 WdfIoResourceListCreate 的程式代碼範例，請參閱 WdfIoResourceRequirementsListAppendIoResList。

規格需求

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

另請參閱

WDF_OBJECT_ATTRIBUTES