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

另請參閱

EvtDeviceResourcesQuery