EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY回呼函式 (wdfpdo.h)
[僅適用於 KMDF]
總線驅動程式的 EvtDeviceResourceRequirementsQuery 事件回呼函式會建立資源需求清單，代表裝置所需的硬體資源。
語法
EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;
NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
[in] WDFDEVICE Device,
[in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}
參數
[in] Device
架構裝置物件的句柄。
[in] IoResourceRequirementsList
架構 resource-requirements-list 物件的句柄，代表空的資源需求清單。
傳回值
如果驅動程式未發生任何錯誤，它必須傳回STATUS_SUCCESS (是否指定任何必要的硬件资源) 。 如果驅動程式遇到錯誤，它必須傳回 NT_SUCCESS 評估為 FALSE 的 NTSTATUS 值。
如需此回呼函式傳回值的詳細資訊，請參閱 報告裝置失敗。
備註
架構型總線驅動程式可以提供 EvtDeviceResourceRequirementsQuery 回 呼函式。 若要註冊此回呼函式，總線驅動程式會呼叫 WdfPdoInitSetEventCallbacks。
架構會呼叫總線驅動程式的 EvtDeviceResourceRequirementsQuery 回 呼函式，以取得裝置 的資源需求清單 。
驅動程式必須將硬體資源的邏輯設定填入提供的 resource-requirements-list 物件，以允許裝置正常運作的硬體資源。
為了建立資源需求清單，驅動程式會呼叫 framework resource-range-list 物件方法，此方法會將資源描述項新增至邏輯組態，以及將邏輯設定新增至資源需求清單的架構 resource-requirements-list 物件方法。
如需硬體資源及建立資源需求清單的詳細資訊，請參閱 Framework-Based 驅動程式的硬體資源。
如果驅動程式是在 Windows 7 之前的作業系統版本上執行，則總線驅動程式可以使用 EvtDeviceResourceRequirementsQuery 在列舉子裝置之前，在子裝置上 設定裝置屬性 。
若要在 Windows 7 或更新版本上設定裝置屬性，總線驅動程式可以提供預處理器IRP_MN_DEVICE_ENUMERATED例程。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfpdo.h (包含 Wdf.h) |
| IRQL | PASSIVE_LEVEL |