IStiDevice ::RawReadCommand, méthode (sti.h)

Article
02/07/2025

La méthode IStiDevice ::RawReadCommand lit les informations de commande à partir d’un appareil toujours image.

Syntaxe

HRESULT RawReadCommand(
  [in, out]      LPVOID       lpBuffer,
  [in, out]      LPDWORD      lpdwNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Paramètres

[in, out] lpBuffer

Pointeur fourni par l’appelant vers une mémoire tampon pour recevoir les données lues à partir de l’appareil.

[in, out] lpdwNumberOfBytes

Pointeur fourni par l’appelant vers un DWORD. L’appelant doit charger le DWORD avec le nombre d’octets dans la mémoire tampon vers laquelle pointe lpBuffer. Au retour, il contiendra le nombre d’octets réellement lus.

[in, optional] lpOverlapped

Pointeur facultatif fourni par l’appelant vers une structure QUI SE CHEVAUCHE (décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows).

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

La méthode IStiDevice ::RawReadCommand appelle IStiUSD ::RawReadCommand, qui est exportée par des minidrivers fournis par le fournisseur. La signification du contenu de la mémoire tampon est définie par le fournisseur.

Il n’est nécessaire d’appeler IStiDevice ::RawReadCommand si les informations de commande et de données sont lues à partir d’un appareil par différentes méthodes. Pour d’autres appareils, IStiDevice ::RawReadData pouvez être utilisé pour les commandes et les données.

Avant d’appeler IStiDevice ::RawReadCommand, 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é.

Un appel à IStiDevice ::RawReadCommand doit être précédé d’un appel à IStiDevice ::LockDevice et suivi d’un appel à IStiDevice ::UnLockDevice.

Exigences

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

Partager via