Método IStiUSD::RawReadData (stiusd.h)
Un minidriver de imagen fija IStiUSD::RawReadData método lee los datos de un dispositivo de imagen todavía.
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 (que se describe en la documentación del SDK de Microsoft Windows).
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.
Observaciones
Normalmente, un minidriver de imágenes todavía implementa este método mediante una llamada a readFile (que se describe 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 | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | stiusd.h (incluya Stiusd.h) |