PosCxClaimDevice, fonction (poscx.h)

PosCxClaimDevice est appelé pour revendiquer un appareil en vue d’une utilisation exclusive.

L’appelant doit appeler PosCxReleaseDevice lorsque l’appareil n’est plus nécessaire.

Si l’appareil est déjà revendiqué, l’appelant doit attendre que l’accès soit accordé.

Syntaxe

NTSTATUS PosCxClaimDevice(
  [in] WDFDEVICE  device,
  [in] WDFREQUEST request
);

Paramètres

[in] device

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

[in] request

Handle vers un objet de requête d’infrastructure qui représente la demande. Cette demande doit provenir d’une file d’attente d’E/S WDF.

Valeur retournée

Les valeurs de retour possibles sont les suivantes :

Valeur Description
STATUS_SUCCESS L’appareil a été correctement revendiqué.
STATUS_PENDING La demande de revendication a été mise en file d’attente.
STATUS_DEVICE_NOT_READY La bibliothèque PosCx n’a pas été correctement initialisée.
STATUS_ACCESS_DENIED Le propriétaire actuel a conservé la propriété de l’appareil.

Configuration requise

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