Partager via


IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE IOCTL (pointofservicedriverinterface.h)

Cette fonction de contrôle d’E/S est utilisée pour conserver une revendication sur un appareil lorsqu’un client est averti que sa revendication sur l’appareil est contestée par un autre client.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Non utilisé avec cette opération ; défini sur NULL .

Longueur de la mémoire tampon d’entrée

Non utilisé avec cette opération ; défini sur 0 (zéro).

Mémoire tampon de sortie

Non utilisé avec cette opération ; défini sur NULL .

Longueur de la mémoire tampon de sortie

Non utilisé avec cette opération ; défini sur 0 (zéro)

Bloc d’état

Retourne TRUE en cas de réussite ; sinon, retourne FALSE.

Remarques

Pour obtenir des informations d’erreur étendues, appelez GetLastError. La liste suivante présente les valeurs d’erreur courantes :

  • STATUS_ACCESS_DENIED : l’appareil est actuellement revendiqué par un autre client.

  • STATUS_DEVICE_NOT_READY : la bibliothèque POS n’a pas été initialisée avec succès.

Ce IOCTL fonctionne uniquement si le client a précédemment appelé IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE.

Lors de la gestion de ce IOCTL, le pilote peut appeler PosCxRetainDevice. L’enregistreur de pilotes n’a pas besoin de gérer la contention de revendication, car la bibliothèque PosCx détermine qui obtient la revendication.

Exigences

Exigence Valeur
d’en-tête pointofservicedriverinterface.h (include Pointofservicedriverinterface.h)