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) |