WdfIoResourceListGetDescriptor 函式 (wdfresource.h)

  • 發行項

[僅適用於 KMDF]

WdfIoResourceListGetDescriptor 方法會傳回資源需求列表邏輯組態中包含的資源描述元指標。

語法

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

參數

[in] ResourceList

架構 resource-range-list 物件的句柄，代表裝置硬體資源的邏輯設定。

[in] Index

以零起始的值，做為 ResourceList 所指定之邏輯組態的索引。

傳回值

如果索引值有效，WdfIoResourceListGetDescriptor 會傳回描述 Index 參數識別的硬體資源之IO_RESOURCE_DESCRIPTOR結構的指標。 否則，方法會傳回 NULL。

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

備註

驅動程式無法修改 WdfIoResourceListGetDescriptor 擷取之IO_RESOURCE_DESCRIPTOR結構的內容。 若要修改資源描述元，驅動程式可以呼叫 WdfIoResourceListUpdateDescriptor。

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

範例

如需使用 WdfIoResourceListGetDescriptor 的程式碼範例，請參閱 WdfIoResourceRequirementsListGetIoResList。

規格需求

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

另請參閱

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor