EVT_WDF_DEVICE_RESOURCES_QUERY回呼函式 (wdfpdo.h)
[僅適用於 KMDF]
總線驅動程式的 EvtDeviceResourcesQuery 事件回呼函式會建立代表指定裝置 開機設定的資源清單。
語法
EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;
NTSTATUS EvtWdfDeviceResourcesQuery(
[in] WDFDEVICE Device,
[in] WDFCMRESLIST Resources
)
{...}
參數
[in] Device
架構裝置物件的句柄。
[in] Resources
架構資源清單物件的句柄,代表空的資源清單。
傳回值
如果驅動程式未遇到任何錯誤,它必須傳回STATUS_SUCCESS (它是否指定开机设定资源) 。 如果驅動程式遇到錯誤,它必須傳回 NT_SUCCESS 評估為 FALSE 的 NTSTATUS 值。
如需此回呼函式傳回值的詳細資訊,請參閱 報告裝置失敗。
備註
架構型總線驅動程式可以提供 EvtDeviceResourcesQuery 回 呼函式。 若要註冊此回呼函式,總線驅動程式會呼叫 WdfPdoInitSetEventCallbacks。
架構會呼叫總線驅動程式的 EvtDeviceResourcesQuery 回 呼函式,以取得指定裝置開機設定 的資源清單 。
驅動程式必須將代表裝置開機需求的硬體資源填入所提供的資源清單物件。 PnP 裝置的驅動程式會從系統 BIOS 取得此需求資訊。
若要建立資源清單,驅動程式會呼叫 架構資源清單物件方法 ,將資源新增至 Resources 參數所代表的資源清單物件。如需硬體資源及建立資源清單的詳細資訊,請參閱 Framework-Based 驅動程式的硬體資源。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最低 KMDF 版本 | 1.0 |
標頭 | wdfpdo.h (包含 Wdf.h) |
IRQL | PASSIVE_LEVEL |