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

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

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 des données à envoyer à l’appareil.

nNumberOfBytes

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

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

Avant d’appeler IStiDevice ::RawWriteCommand, 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 ::RawWriteCommand doit être précédé d’un appel à IStiDevice ::LockDevice et suivi d’un appel à IStiDevice ::UnLockDevice.

Configuration requise