共用方式為


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

要求

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

另請參閱

WDF_OBJECT_ATTRIBUTES