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 un travail supplémentaire. 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 pour un objet d’appareil framework qui représente l’appareil.

[in] deviceInterfaceTag

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

Valeur retournée

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS ou une autre valeur de status pour laquelle NT_SUCCESS(status) est 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.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête poscx.h (inclure Poscx.h)