Compartir a través de


Método IStiUSD::RawReadData (stiusd.h)

Un método IStiUSD::RawReadData de una imagen fija lee los datos de un dispositivo de imagen fija.

Sintaxis

HRESULT RawReadData(
  LPVOID       lpBuffer,
  LPDWORD      lpdwNumberOfBytes,
  LPOVERLAPPED lpOverlapped
);

Parámetros

lpBuffer

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

lpdwNumberOfBytes

Puntero proporcionado por el autor de la llamada a un DWORD. El autor de la llamada carga el DWORD con el número de bytes del búfer al que apunta lpBuffer. El controlador debe reemplazar este valor por el número de bytes leídos realmente.

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 debe devolver S_OK. De lo contrario, debe devolver uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Comentarios

Normalmente, un minidriver de imagen fija implementa este método llamando a ReadFile (descrito en la documentación de Windows SDK).

En el caso de los dispositivos USB, se puede lograr un mejor rendimiento si las solicitudes de lectura están alineadas con los límites máximos de tamaño de paquete. Se pueden obtener tamaños máximos de paquete llamando a DeviceIoControl, especificando el código de control de E/S de IOCTL_GET_CHANNEL_ALIGN_RQST .

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado stiusd.h (incluya Stiusd.h)

Consulte también

IStiDevice::RawReadData

IStiUSD