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

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

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 de 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 SELECT_INTERFACE URB. Essa estrutura de interface corresponde a uma única interface isocrona 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 de USBCAMD_Pipe_Config_Descriptor que descreve a associação entre pipes e fluxos.

DeviceDescriptor

Ponteiro para o USB_DEVICE_DESCRIPTOR deste dispositivo.

Valor de retorno

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

Observações

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 isocrona. 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 será usada 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.