共用方式為

EVT_WDF_DEVICE_EJECT回呼函式 (wdfpdo.h)

  • 發行項

[僅適用於 KMDF]

驅動程式的 EvtDeviceEject 事件回呼函式會處理從其停駐站退出裝置所需的作業。

語法

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

NTSTATUS EvtWdfDeviceEject(
  [in] WDFDEVICE Device
)
{...}

參數

[in] Device

架構裝置物件的句柄。

傳回值

如果作業成功，驅動程式必須傳回STATUS_SUCCESS。 否則，它必須傳回 NT_SUCCESS 評估為 FALSE 的 NTSTATUS 值。 請勿傳回STATUS_NOT_SUPPORTED。

如需傳回值的詳細資訊，請參閱 報告裝置失敗。

備註

架構型總線驅動程式可以提供 EvtDeviceEject 回呼函式。 如果驅動程式必須執行實際從裝置停駐站退出其中一個列舉子裝置的作業，則總線驅動程序必須提供 EvtDeviceEject 回呼函式。 若要註冊此回呼函式，總線驅動程式必須呼叫 WdfPdoInitSetEventCallbacks。

呼叫 EvtDeviceEject 回呼函式之前，架構會呼叫驅動程式的 EvtDeviceD0Exit 和 EvtDeviceReleaseHardware 回呼函式。

如果驅動程式的 EvtDeviceEject 回呼函式傳回STATUS_SUCCESS，架構會更新驅動程式的子清單，指出已退出的裝置已無法使用。 因此，驅動程式不需要呼叫 WdfPdoMarkMissing 或 WdfChildListUpdateChildDescriptionAsMissing。

如需裝置退出的詳細資訊，請參閱 支援退出的裝置。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
標頭 wdfpdo.h (包含 Wdf.h)
IRQL PASSIVE_LEVEL

另請參閱

EvtDeviceSetLock