IStiUSD ::RawReadData, méthode (stiusd.h)

La méthode IStiUSD ::RawReadData d’un minidriver d’image fixe lit les données d’un appareil d’image fixe.

Syntaxe

HRESULT RawReadData(
  LPVOID       lpBuffer,
  LPDWORD      lpdwNumberOfBytes,
  LPOVERLAPPED lpOverlapped
);

Paramètres

lpBuffer

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

lpdwNumberOfBytes

Pointeur fourni par l’appelant vers un DWORD. L’appelant charge le DWORD avec le nombre d’octets dans la mémoire tampon pointée par lpBuffer. Le pilote doit remplacer cette valeur par le nombre d’octets effectivement lus.

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 doit retourner S_OK. Sinon, il doit retourner l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

Un minidriver d’image fixe implémente généralement cette méthode en appelant ReadFile (décrit dans la documentation du Kit de développement logiciel (SDK) Windows.

Pour les périphériques USB, de meilleures performances peuvent être obtenues si les demandes de lecture sont alignées sur les limites de taille de paquet maximale. Vous pouvez obtenir des tailles de paquets maximales en appelant DeviceIoControl, en spécifiant le code de contrôle d’E /S IOCTL_GET_CHANNEL_ALIGN_RQST.

Configuration requise

Voir aussi

IStiDevice ::RawReadData

IStiUSD