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) |