Método IStiDevice::RawWriteCommand (sti.h)

El método IStiDevice::RawWriteCommand envía información de comandos a un dispositivo de imagen fija.

Sintaxis

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

Parámetros

[in] lpBuffer

Puntero proporcionado por el autor de la llamada a un búfer que contiene los datos que se van a enviar al dispositivo.

nNumberOfBytes

Número proporcionado por el autor de la llamada de bytes que se va a escribir. Este es el número de bytes del búfer al que apunta lpBuffer.

[in, optional] lpOverlapped

Opcional, puntero proporcionado por el autor de la llamada a una estructura SUPERPUESTA (descrita en la documentación de Microsoft Windows SDK).

Valor devuelto

Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Comentarios

El método IStiDevice::RawWriteCommand llama a IStiUSD::RawWriteCommand, que exporta los minidrivers proporcionados por el proveedor. El significado del contenido del búfer es definido por el proveedor.

Solo es necesario llamar a IStiDevice::RawWriteCommand si los comandos y los datos se escriben en un dispositivo mediante métodos diferentes. Para otros dispositivos, IStiDevice::RawWriteData se puede usar tanto para comandos como para datos.

Antes de llamar a IStiDevice::RawWriteCommand, los clientes de la interfaz COM IStiDevice deben llamar a IStillImage::CreateDevice para obtener un puntero de interfaz IStiDevice , que proporciona acceso a un dispositivo especificado.

Una llamada a IStiDevice::RawWriteCommand debe ir precedida de una llamada a IStiDevice::LockDevice y seguida de una llamada a IStiDevice::UnLockDevice.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	sti.h (include Sti.h)