共用方式為


WdfIoResourceListGetDescriptor 函式 (wdfresource.h)

[僅適用於 KMDF]

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

語法

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

參數

[in] ResourceList

架構資源範圍清單物件的句柄,代表裝置硬體資源的邏輯組態。

[in] Index

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

傳回值

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

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

言論

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

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

例子

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

要求

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

另請參閱

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor