[僅適用於 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（不論它是否指定任何必要的硬體資源）。 如果驅動程式發生錯誤，它必須傳回NTSTATUS值，NT_SUCCESS 評估為 FALSE 。
如需此回呼函式傳回值的詳細資訊，請參閱 報告裝置失敗。
備註
架構型總線驅動程式可以提供 EvtDeviceResourceRequirementsQuery 回呼函式。 若要註冊此回呼函式，總線驅動程式會呼叫 WdfPdoInitSetEventCallbacks。
架構會呼叫總線驅動程式的 EvtDeviceResourceRequirementsQuery 回呼函式，以取得裝置 資源需求清單。
驅動程式必須以硬體資源的邏輯組態填入提供的 resource-requirements-list 物件，以允許裝置正常運作的硬體資源。
若要建立資源需求清單，驅動程式會呼叫 framework resource-range-list 物件方法，此方法會將資源描述項新增至邏輯組態，以及將邏輯組態新增至資源需求列表的架構 resource-requirements-list 物件方法。
如需硬體資源及建立資源需求清單的詳細資訊，請參閱 Framework-Based 驅動程式的硬體資源。
如果驅動程式是在 Windows 7 之前的作系統版本上執行，則總線驅動程式可以在列舉子系之前，先使用 EvtDeviceResourceRequirementsQuery 來 在子裝置上設定裝置屬性。
若要在 Windows 7 或更新版本上 設定裝置屬性，總線驅動程式可以 為 IRP_MN_DEVICE_ENUMERATED提供前置處理例程。
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標題 | wdfpdo.h （包括 Wdf.h） |
| IRQL | PASSIVE_LEVEL |