PCAM_CONFIGURE_ROUTINE_EX função de retorno de chamada (usbcamdi.h)

Artigo
02/29/2024

A função de retorno de chamada CamConfigureEx de um minidriver de câmera configura a interface de streaming isócrona.

Sintaxe

PCAM_CONFIGURE_ROUTINE_EX PcamConfigureRoutineEx;

NTSTATUS PcamConfigureRoutineEx(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  ULONG PipeConfigListSize,
  PUSBCAMD_Pipe_Config_Descriptor PipeConfig,
  PUSB_DEVICE_DESCRIPTOR DeviceDescriptor
)
{...}

Parâmetros

BusDeviceObject

Ponteiro para o objeto de dispositivo do minidriver da câmera criado pelo hub USB.

DeviceContext

Ponteiro para o contexto do dispositivo do minidriver da câmera.

Interface

Ponteiro para a estrutura de USBD_INTERFACE_INFORMATION inicializada com os valores adequados para uma solicitação URB SELECT_INTERFACE. Essa estrutura de interface corresponde a uma única interface isócrona no dispositivo.

ConfigurationDescriptor

Ponteiro para o USB_CONFIGURATION_DESCRIPTOR deste dispositivo.

PipeConfigListSize

Especifica o número de elementos na matriz PipeConfig .

PipeConfig

Ponteiro para uma matriz USBCAMD_Pipe_Config_Descriptor que descreve a associação entre pipes e fluxos.

DeviceDescriptor

Ponteiro para o USB_DEVICE_DESCRIPTOR deste dispositivo.

Retornar valor

CamConfigureEx retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Os minidrivers de câmera usam CamConfigureEx para informar o USBCAMD sobre a relação entre pipes e fluxos descobertos.

O USBCAMD chama a função de retorno de chamada CamConfigureEx para configurar a interface de streaming isócrona. Depois que essa função retornar, o USBCAMD poderá ser notificado sobre qual interface e qual configuração alternativa dentro da interface de streaming de vídeo USB usar para o estado ocioso.

O USBCAMD requer que a câmera tenha uma única descrição de configuração USB e todas as configurações alternativas dentro da interface de streaming de vídeo USB devem ter o mesmo número e tipo de pipes.

O USBCAMD original não chama CamConfigureEx.

Essa função é necessária.