Méthode IStiDevice ::RawReadData (sti.h)
La méthode IStiDevice ::RawReadData lit les données d’un appareil d’image fixe.
Syntaxe
HRESULT RawReadData(
[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 ::RawReadData appelle IStiUSD ::RawReadData, qui est exporté par des mini-disques fournis par le fournisseur.
Avant d’appeler IStiDevice ::RawReadData, 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 ::RawReadData 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) |