Méthode IStiDevice ::LockDevice (sti.h)

La méthode IStiDevice ::LockDevice verrouille un appareil pour une utilisation exclusive par l’appelant.

Syntaxe

HRESULT LockDevice(
  [in] DWORD dwTimeOut
);

Paramètres

[in] dwTimeOut

Valeur de délai d’attente fournie par l’appelant, en millisecondes. Si le verrou n’est pas obtenu au cours de cette période, une erreur est retournée.

Valeur retournée

Si l’opération réussit, la méthode retourne S_OK. Sinon, il retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

Les clients de l’interface COM IStiDevice doivent appeler IStiDevice ::LockDevice avant d’appeler les méthodes suivantes :

IStiDevice ::D eviceReset

IStiDevice ::D iagnostic

IStiDevice ::Escape

IStiDevice ::GetStatus

IStiDevice ::RawReadCommand

IStiDevice ::RawReadData

IStiDevice ::RawWriteCommand

IStiDevice ::RawWriteData

Si la méthode IStiDevice ::LockDevice est en mesure d’obtenir un verrou de niveau IStiDevice sur l’appareil dans le délai d’expiration spécifié, elle appelle ensuite IStiUSD ::LockDevice dans le minidriver fourni par le fournisseur approprié.

Chaque appel à IStiDevice ::LockDevice doit être associé à un appel à IStiDevice ::UnLockDevice.

Avant d’appeler IStiDevice ::LockDevice, les clients de l’interface COM IStiDevice doivent appeler IStillImage ::CreateDevice pour obtenir un pointeur d’interface IStiDevice , qui fournit l’accès à un appareil spécifié.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	sti.h (inclure Sti.h)