WdfCmResourceListGetDescriptor 函式 (wdfresource.h)
[適用於 KMDF 和 UMDF]
WdfCmResourceListGetDescriptor 方法會傳回指定資源清單中所含之資源描述元的指標。
PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
[in] List
架構資源清單物件的句柄,代表裝置的硬體資源清單。
[in] Index
以零起始的值,做為 List 所指定之邏輯組態的索引。
WdfCmResourceListGetDescriptor 會傳回 CM_PARTIAL_RESOURCE_DESCRIPTOR 結構的指標,這個指標會描述 Index 參數所識別的硬體資源,如果索引值有效。 否則,方法會傳回 null 。
如果驅動程式提供無效的物件句柄,就會發生系統錯誤檢查。
您的驅動程式無法修改 WdfCmResourceListGetDescriptor 擷取的資源描述項。
如需資源清單的詳細資訊,請參閱 Framework-Based 驅動程式的硬體資源。
如需使用 WdfCmResourceListGetDescriptor的程式碼範例,請參閱 WdfCmResourceListGetCount。
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
標頭 | wdfresource.h (包括 Wdf.h) |
連結庫 | Wdf01000.sys (KMDF):WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
DDI 合規性規則 | DriverCreate(kmdf),KmdfIrql(kmdf),KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf) |