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(不論它是否指定開機設定資源)。 如果驅動程式發生錯誤,它必須傳回NTSTATUS值,NT_SUCCESS 評估為 FALSE 。
如需此回呼函式傳回值的詳細資訊,請參閱 報告裝置失敗。
備註
架構型總線驅動程式可以提供 EvtDeviceResourcesQuery 回呼函式。 若要註冊此回呼函式,總線驅動程式會呼叫 WdfPdoInitSetEventCallbacks。
架構會呼叫總線驅動程式的 EvtDeviceResourcesQuery 回呼函式,以取得指定裝置開機組態的 資源清單。
驅動程式必須以代表裝置開機需求的硬體資源填入所提供的資源清單物件。 PnP 裝置的驅動程式會從系統 BIOS 取得此需求資訊。
若要建立資源清單,驅動程式會呼叫 架構資源清單物件方法, 將資源新增至資源清單物件,而資源 Resources 參數所代表。如需硬體資源及建立資源清單的詳細資訊,請參閱 Framework-Based 驅動程式的硬體資源。
需求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
標題 | wdfpdo.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL |