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

Consulte también

SRB_INITIALIZE_DEVICE

USBCAMD_DEVICE_DATA2