EVT_WDF_DEVICE_QUERY_STOP funzione di callback (wdfdevice.h)

  • Articolo

[Si applica a KMDF e UMDF]

La funzione di callback dell'evento EvtDeviceQueryStop di un driver determina se un dispositivo specificato può essere arrestato in modo che il gestore PnP possa ridistribuire le risorse hardware del sistema.

Sintassi

EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

Valore restituito

Se il driver determina che il dispositivo può essere arrestato, la funzione di callback EvtDeviceQueryStop deve restituire STATUS_SUCCESS o un altro valore di stato per il quale 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 EvtDeviceQueryStop , 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 EvtDeviceQueryStop 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 EvtDeviceQueryStop , vedere Gestione delle richieste per arrestare un dispositivo.

Il framework non sincronizza la funzione di callback EvtDeviceQueryStop 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

EvtDeviceQueryRemove