PCAM_PROCESS_RAW_FRAME_ROUTINE función de devolución de llamada (usbcamdi.h)
[CamProcessRawVideoFrame no se admite y puede modificarse o no estar disponible en el futuro. En su lugar, use CamProcessRawVideoFrameEx. ]
La función de devolución de llamada CamProcessRawVideoFrame de un minidriver de cámara descodifica un fotograma de vídeo sin formato.
Sintaxis
PCAM_PROCESS_RAW_FRAME_ROUTINE PcamProcessRawFrameRoutine;
NTSTATUS PcamProcessRawFrameRoutine(
PDEVICE_OBJECT BusDeviceObject,
PVOID DeviceContext,
PVOID FrameContext,
PVOID FrameBuffer,
ULONG FrameLength,
PVOID RawFrameBuffer,
ULONG RawFrameLength,
ULONG NumberOfPackets,
PULONG BytesReturned
)
{...}
Parámetros
BusDeviceObject
Puntero al objeto de dispositivo del minidriver de la cámara creado por el concentrador USB.
DeviceContext
Puntero al contexto del dispositivo del minidriver de la cámara.
FrameContext
Puntero al contexto de fotogramas del minidriver de la cámara.
FrameBuffer
Puntero al búfer que recibe el fotograma de vídeo procesado final. Consulte la sección Comentarios para obtener más información sobre cómo USBCAMD usa este parámetro.
FrameLength
Especifica la longitud del búfer de fotogramas (de la solicitud de lectura original) en bytes.
RawFrameBuffer
Puntero al búfer que contiene los paquetes USB recibidos. Consulte la sección Comentarios para obtener más información sobre cómo USBCAMD usa este parámetro.
RawFrameLength
Especifica la longitud de RawFrameBuffer en bytes.
NumberOfPackets
Especifica el número de paquetes USB recibidos en RawFrameBuffer.
BytesReturned
Puntero al número de bytes transferidos. El minidriver debe establecerlo en cero si encuentra errores durante el procesamiento, como se describe en Data Flow Uso de canalizaciones isócrónicas. Consulte la sección Comentarios para obtener más información sobre cómo USBCAMD usa este parámetro.
Valor devuelto
CamProcessRawVideoFrame devuelve STATUS_SUCCESS o un código de error adecuado.
Comentarios
Antes de que USBCAMD llame a la devolución de llamada CamProcessRawVideoFrame del minidriver, establece el primer DWORD en el búfer al que apunta el parámetro FrameBuffer al valor 0xdeadbeef. Después de llamar al USBCAMD de devolución de llamada CamProcessRawVideoFrame del minidriver comprueba el primer DWORD del búfer al que apunta el parámetro FrameBuffer para el valor 0xdeadbeef para determinar si CamProcessRawVideoFrame copió correctamente el fotograma de vídeo del búfer al que apunta el parámetro RawFrameBuffer en el búfer al que apunta el parámetro FrameBuffer .
Los minicontroladores de cámara que deben mantener la compatibilidad con versiones anteriores con el USBCAMD original deben usar la estructura USBCAMD_DEVICE_DATA y sus funciones de devolución de llamada asociadas (es decir, las funciones de devolución de llamada que no contienen el sufijo "Ex").
Esta función es opcional.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | usbcamdi.h (incluye Usbcamdi.h) |
| IRQL | PASSIVE_LEVEL |