EVT_WDF_DEVICE_QUERY_REMOVE fonction de rappel (wdfdevice.h)

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtDeviceQueryRemove pilote détermine si un appareil spécifié peut être arrêté et supprimé.

Syntaxe

EVT_WDF_DEVICE_QUERY_REMOVE EvtWdfDeviceQueryRemove;

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

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

Valeur de retour

Si le pilote détermine que l’appareil peut être arrêté et supprimé, la fonction de rappel EvtDeviceQueryRemove doit retourner STATUS_SUCCESS ou une autre valeur d’état pour laquelle NT_SUCCESS(status) est égal TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) est égal à FALSE. Ne retournez pas STATUS_NOT_SUPPORTED.

Remarques

Pour inscrire une fonction de rappel EvtDeviceQueryRemove, un pilote doit appeler WdfDeviceInitSetPnpPowerEventCallbacks.

Si l’appareil et le pilote prennent en charge la mise hors tension inactive, il se peut que l’appareil ne soit pas dans son état de fonctionnement lorsque l’infrastructure appelle la fonction de rappel evtDeviceQueryRemove du pilote. La fonction de rappel peut appeler WdfDeviceStopIdle pour forcer l’appareil à son état opérationnel (D0), puis la fonction de rappel peut appeler WdfDeviceResumeIdle avant de retourner.

Pour plus d’informations sur la fonction de rappel EvtDeviceQueryRemove, consultez Gestion des demandes pour arrêter un appareil.

L’infrastructure ne synchronise pas les EvtDeviceQueryRemove fonction de rappel avec d’autres fonctions de rappel PnP et de gestion de l’alimentation. Pour plus d’informations sur la façon dont l’infrastructure synchronise l’exécution des fonctions de rappel d’événements d’un pilote, consultez Using Automatic Synchronization.

Exigences

Voir aussi

EvtDeviceQueryStop