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

El método IStiDevice::RawReadCommand lee la información de comandos de un dispositivo de imagen todavía.

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. A cambio, 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 (que se describe en la documentación del SDK de Microsoft Windows).

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.

Observaciones

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

Solo es necesario llamar a IStiDevice::RawReadCommand si los comandos y la información de datos se leen desde un dispositivo mediante métodos diferentes. Para otros dispositivos, IStiDevice::RawReadData se pueden usar tanto para comandos como para datos.

Antes de llamar a IStiDevice::RawReadCommand, los clientes de la interfaz IStiDevice COM 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