función USBCAMD_InitializeNewInterface (usbcamdi.h)
La función USBCAMD_InitializeNewInterface proporciona USBCAMD con toda la información necesaria para configurar el minidriver de cámara para que funcione correctamente con el controlador de clase stream y el controlador del bus USB.
Sintaxis
ULONG USBCAMD_InitializeNewInterface(
[in] PVOID DeviceContext,
[in] PVOID DeviceData,
[in] ULONG Version,
[in] ULONG CamControlFlag
);
Parámetros
[in] DeviceContext
Puntero al contexto específico del dispositivo.
[in] DeviceData
Puntero a una estructura de USBCAMD_DEVICE_DATA2 .
[in] Version
Especifica la información de versión. Este valor debe establecerse en el valor USBCAMD_VERSION_200 para su uso con USBCAMD versión 2.0.
[in] CamControlFlag
Especifica cómo debe interactuar USBCAMD y el minidriver de cámara. El minidriver de cámara debe establecer este valor en uno o varios de los siguientes elementos:
| Marca | Significado |
|---|---|
| USBCAMD_CamControlFlag_NoVideoRawProcessing | Si el minidriver de la cámara no necesita funcionar en vídeo, debe establecer el USBCAMD_CamControlFlag_NoVideoRawProcessing. Esto elimina una copia del búfer. |
| USBCAMD_CamControlFlag_NoStillRawProcessing | Si el minidriver de cámara no necesita funcionar en el marco sin procesar de la imagen todavía, debe establecer el USBCAMD_CamControlFlag_NoStillRawProcessing bit para eliminar una copia de búfer. |
| USBCAMD_CamControlFlag_AssociatedFormat | El bit de USBCAMD_CamControlFlag_AssociatedFormat debe establecerse si el minidriver de la cámara usa el mismo formato para el vídeo que en la patilla virtual. Una vez establecida esta marca, USBCAMD no permite que la patilla virtual se abra en un formato diferente del pin de vídeo. El bit de USBCAMD_CamControlFlag_AssociatedFormat solo se debe establecer cuando la patilla virtual genera fotogramas con el mismo formato que los fotogramas de vídeo. |
| USBCAMD_CamControlFlag_EnableDeviceEvents | Al establecer el USBCAMD_CamControlFlag_EnableDeviceEvents, se expone un evento de dispositivo al controlador de clase stream y Microsoft DirectShow. Esto permite que un monitor STI inicie una aplicación de imagen fija si el botón todavía está presionado en la cámara. USBCAMD envía un evento de KSEVENT_VIDCAPTOSTI_EXT_TRIGGER si se establece este bit y se presiona el botón de la cámara. |
Valor devuelto
USBCAMD_InitializeNewInterface devuelve el valor USBCAMD_VERSION_200.
Comentarios
La versión 2.0 de USBCAMD llama a esta función.
El minidriver de cámara debe llamar a la función USBCAMD_InitializeNewInterface al recibir una solicitud de SRB_INITIALIZE_DEVICE .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | usbcamdi.h (incluya Usbcamdi.h) |
| Library | Usbcamd2.lib |