EVT_WDF_DEVICE_SET_LOCK fonction de rappel (wdfpdo.h)

[S’applique uniquement à KMDF]

La fonction de rappel d’événement EvtDeviceSetLock pilote verrouille l’appareil spécifié afin qu’il ne puisse pas être éjecté ou déverrouille l’appareil afin qu’il puisse être éjecté.

Syntaxe

EVT_WDF_DEVICE_SET_LOCK EvtWdfDeviceSetLock;

NTSTATUS EvtWdfDeviceSetLock(
  [in] WDFDEVICE Device,
  [in] BOOLEAN IsLocked
)
{...}

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] IsLocked

Valeur booléenne qui indique si le pilote doit verrouiller ou déverrouiller l’appareil. Si TRUE, le pilote doit verrouiller l’appareil afin qu’il ne puisse pas être éjecté. Si FAUX, le pilote doit déverrouiller l’appareil afin qu’il puisse être éjecté.

Valeur de retour

Si le pilote verrouille ou déverrouille l’appareil, il doit retourner STATUS_SUCCESS. Sinon, il doit retourner une valeur NTSTATUS qui NT_SUCCESS est évaluée comme FALSE.

Pour plus d’informations sur les valeurs de retour de cette fonction de rappel, consultez Reporting Device Failures.

Remarques

Les pilotes de bus basés sur le framework peuvent fournir une fonction de rappel EvtDeviceSetLock. Pour inscrire cette fonction de rappel, les pilotes de bus appellent WdfPdoInitSetEventCallbacks.

L’infrastructure appelle la fonction de rappel evtDeviceSetLock du pilote lorsque le gestionnaire PnP demande au pilote de bus de verrouiller ou déverrouiller l’un de ses appareils enfants énumérés.

L’implémentation d’une fonction de rappel EvtDeviceSetLock pour un appareil équivaut à retourner une valeur NTSTATUS qui prend la valeur FALSE.

Pour plus d’informations sur les valeurs de retour, consultez Prise en charge des appareils éjectables.

Spécifications

Voir aussi

EvtDeviceEjectEject