EVT_WDF_DEVICE_QUERY_REMOVE funzione di callback (wdfdevice.h)

  • Articolo

[Si applica a KMDF e UMDF]

La funzione di callback dell'evento EvtDeviceQueryRemove di un driver determina se un dispositivo specificato può essere arrestato e rimosso.

Sintassi

EVT_WDF_DEVICE_QUERY_REMOVE EvtWdfDeviceQueryRemove;

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

Valore restituito

Se il driver determina che il dispositivo può essere arrestato e rimosso, la funzione di callback EvtDeviceQueryRemove deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(stato) è uguale a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE. Non restituire STATUS_NOT_SUPPORTED.

Commenti

Per registrare una funzione di callback EvtDeviceQueryRemove , un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.

Se il dispositivo e il driver supportano l'alimentazione inattiva, il dispositivo potrebbe non trovarsi nello stato di funzionamento quando il framework chiama la funzione di callback EvtDeviceQueryRemove del driver. La funzione di callback può chiamare WdfDeviceStopIdle per forzare il dispositivo nello stato di lavoro (D0) e quindi la funzione di callback può chiamare WdfDeviceResumeIdle prima di restituire.

Per altre informazioni sulla funzione di callback EvtDeviceQueryRemove , vedere Gestione delle richieste per arrestare un dispositivo.

Il framework non sincronizza la funzione di callback EvtDeviceQueryRemove con altre funzioni di callback di PnP e power management. Per informazioni su come il framework sincronizza l'esecuzione delle funzioni di callback degli eventi di un driver, vedere Uso della sincronizzazione automatica.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfdevice.h (includere Wdf.h)
IRQL PASSIVE_LEVEL

Vedi anche

EvtDeviceQueryStop