WdfFdoInitSetEventCallbacks 函式 (wdffdo.h)

  • 發行項

[僅適用於 KMDF]

WdfFdoInitSetEventCallbacks 方法會為指定的裝置註冊架構型函式驅動程式的事件回呼函式。

語法

void WdfFdoInitSetEventCallbacks(
  [in] PWDFDEVICE_INIT          DeviceInit,
  [in] PWDF_FDO_EVENT_CALLBACKS FdoEventCallbacks
);

參數

[in] DeviceInit

驅動程式從其 EvtDriverDeviceAdd 回呼函式取得的WDFDEVICE_INIT結構的指標。

[in] FdoEventCallbacks

驅動程式配置 WDF_FDO_EVENT_CALLBACKS 結構的指標。

傳回值

無

備註

呼叫 WdfFdoInitSetEventCallbacks 之前，驅動程式必須配置 WDF_FDO_EVENT_CALLBACKS 結構，並在結構中填入驅動程式事件回呼函式的指標。

驅動程序必須先呼叫 WdfFdoInitSetEventCallbacks ，才能呼叫 WdfDeviceCreate。 如需呼叫 WdfDeviceCreate 的詳細資訊，請參閱 建立架構裝置物件。

如需 WdfFdoInitSetEventCallbacks 方法的詳細資訊，請參閱 在函式驅動程式中建立裝置物件。

範例

下列程式代碼範例會初始化WDF_FDO_EVENT_CALLBACKS結構，然後呼叫 WdfFdoInitSetEventCallbacks。

WDF_FDO_EVENT_CALLBACKS fdoCallbacks;

WDF_FDO_EVENT_CALLBACKS_INIT(&fdoCallbacks);
fdoCallbacks.EvtDeviceFilterAddResourceRequirements = MyEvtDeviceFilterAddResourceRequirements;
fdoCallbacks.EvtDeviceFilterRemoveResourceRequirements = MyEvtDeviceFilterRemoveResourceRequirements;
fdoCallbacks.EvtDeviceRemoveAddedResources = MyEvtDeviceRemoveAddedResources;

WdfFdoInitSetEventCallbacks(
                            DeviceInit,
                            &fdoCallbacks
                            );

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
標頭 wdffdo.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL PASSIVE_LEVEL
DDI 合規性規則 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf ) 、KmdfIrqlExplicit (kmdf)

另請參閱

WDF_FDO_EVENT_CALLBACKS_INIT