EVT_WDF_DEVICE_EJECT funzione di callback (wdfpdo.h)

[Si applica solo a KMDF]

La funzione di callback dell'evento EvtDeviceEject di un driver gestisce le operazioni necessarie per espellere un dispositivo dalla sua stazione di ancoraggio.

Sintassi

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

Valore restituito

Se l'operazione ha esito positivo, il driver deve restituire STATUS_SUCCESS. In caso contrario, deve restituire un valore NTSTATUS che NT_SUCCESS restituisce FALSE. Non restituire STATUS_NOT_SUPPORTED.

Per altre informazioni sui valori restituiti, vedere Segnalazione di errori dei dispositivi.

Commenti

I driver di bus basati su framework possono fornire una funzione di callback EvtDeviceEject . Un autista di autobus deve fornire una funzione di callback EvtDeviceEject se il driver deve eseguire operazioni che eseguano fisicamente uno dei dispositivi figlio enumerati dalla stazione di ancoraggio del dispositivo. Per registrare questa funzione di callback, il driver del bus deve chiamare WdfPdoInitSetEventCallbacks.

Prima di chiamare la funzione di callback EvtDeviceEject , il framework chiama le funzioni di callback EvtDeviceD0Exit e EvtDeviceReleaseHardware .

Se la funzione di callback EvtDeviceEject di un driver restituisce STATUS_SUCCESS, il framework aggiorna l'elenco figlio del driver per indicare che il dispositivo espulso non è più disponibile. Pertanto, il driver non deve chiamare WdfPdoMarkMissing o WdfChildListUpdateChildDescriptionAsMissing.

Per altre informazioni sull'espulsione del dispositivo, vedere Supporto di dispositivi espulibili.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1,0
Intestazione	wdfpdo.h (include Wdf.h)
IRQL	PASSIVE_LEVEL

Vedi anche

EvtDeviceSetLock