Partager via


IStiDevice ::LockDevice, méthode (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 pendant cette période, une erreur est retournée.

Valeur de retour

Si l’opération réussit, la méthode retourne S_OK. Sinon, elle 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 iagnostique

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 IStiDeviceniveau sur l’appareil dans le délai d’attente spécifié, il 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 IStiDevice COM doivent appeler IStillImage ::CreateDevice pour obtenir un pointeur d’interface IStiDevice , qui fournit l’accès à un appareil spécifié.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête sti.h (include Sti.h)