Partager via

EVT_POS_CX_DEVICE_REMOTE_RETAIN fonction de rappel (poscx.h)

  • Article

Le rappel EVT_POS_CX_DEVICE_REMOTE_RETAIN est appelé chaque fois que PosCx tente de conserver une revendication sur un périphérique réseau et permet au pilote d’effectuer des tâches supplémentaires. Ce rappel est généralement utilisé uniquement avec les appareils connectés au réseau qui nécessitent une logique supplémentaire pour gérer les transitions de propriété.

Syntaxe

EVT_POS_CX_DEVICE_REMOTE_RETAIN EvtPosCxDeviceRemoteRetain;

NTSTATUS EvtPosCxDeviceRemoteRetain(
  [in] WDFDEVICE device,
  [in] ULONG deviceInterfaceTag
)
{...}

Paramètres

[in] device

Handle vers un objet d’appareil framework qui représente l’appareil.

[in] deviceInterfaceTag

Identificateur utilisé pour spécifier l’interface qui est conservée dans un appareil multi-fonction. Pour un appareil à interface unique, cette valeur doit être 0.

Valeur de retour

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS ou une autre valeur d’état pour laquelle NT_SUCCESS(status) a la valeur TRUE.

Si le pilote ne parvient pas à terminer la transaction de conservation à distance, il doit retourner STATUS_ACCESS_DENIED afin que l’échec se propage à l’application.

Exigences

Exigence Valeur
plateforme cible Windows
d’en-tête poscx.h (include Poscx.h)