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

Une méthode de minidriver IStiUSD ::RawReadData lit les données d’un appareil toujours image.

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 réellement lus.

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 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 toujours image 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.

Exigences

Voir aussi

IStiDevice ::RawReadData

IStiUSD