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

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

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 pointée par lpBuffer. Au retour, il contiendra le nombre d’octets effectivement lus.

[in, optional] lpOverlapped

Pointeur facultatif fourni par l’appelant vers une structure CHEVAUCHEMENT (décrit dans la documentation Microsoft Windows SDK).

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

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

Il est uniquement 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 peut être utilisé pour les commandes et les données.

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

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

Configuration requise

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