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

El método IStiDevice::RawReadCommand lee información de comandos de un dispositivo de imagen fija.

Sintaxis

HRESULT RawReadCommand(
  [in, out]      LPVOID       lpBuffer,
  [in, out]      LPDWORD      lpdwNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parámetros

[in, out] lpBuffer

Puntero proporcionado por el autor de la llamada a un búfer para recibir datos leídos del dispositivo.

[in, out] lpdwNumberOfBytes

Puntero proporcionado por el autor de la llamada a un DWORD. El autor de la llamada debe cargar el DWORD con el número de bytes del búfer al que apunta lpBuffer. Al devolver, contendrá el número de bytes leídos realmente.

[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::RawReadCommand llama a IStiUSD::RawReadCommand, 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::RawReadCommand si los métodos diferentes leen la información de los comandos y datos de un dispositivo. Para otros dispositivos, IStiDevice::RawReadData se puede usar tanto para comandos como para datos.

Antes de llamar a IStiDevice::RawReadCommand, 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::RawReadCommand 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)