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

Article
02/07/2025

La méthode IStiDevice ::RawWriteCommand envoie des informations de commande à un appareil toujours image.

Syntaxe

HRESULT RawWriteCommand(
  [in]           LPVOID       lpBuffer,
                 DWORD        nNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Paramètres

[in] lpBuffer

Pointeur fourni par l’appelant vers une mémoire tampon contenant les données à envoyer à l’appareil.

nNumberOfBytes

Nombre d’octets fournis par l’appelant à écrire. Il s’agit du nombre d’octets dans la mémoire tampon vers laquelle pointe lpBuffer.

[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 ::RawWriteCommand appelle IStiUSD ::RawWriteCommand, 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 est uniquement nécessaire d’appeler IStiDevice ::RawWriteCommand si des commandes et des données sont écrites sur un appareil par différentes méthodes. Pour d’autres appareils, IStiDevice ::RawWriteData peuvent être utilisés pour les commandes et les données.

Avant d’appeler IStiDevice ::RawWriteCommand, 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 ::RawWriteCommand 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