Compartilhar via


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

[Não há suporte para CamAllocateBandwidth e pode ser alterado ou indisponível no futuro. Em vez disso, use CamAllocateBandwidthEx . ]

A função de retorno de chamada CamAllocateBandwidth de um minidriver de câmera seleciona a configuração alternativa apropriada dentro da interface de streaming de vídeo USB e prepara o dispositivo para transmitir.

Sintaxe

PCAM_ALLOCATE_BW_ROUTINE PcamAllocateBwRoutine;

NTSTATUS PcamAllocateBwRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PULONG RawFrameLength,
  PVOID Format
)
{...}

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.

RawFrameLength

Especifica o tamanho dos dados brutos de quadro do fluxo de pacotes, em bytes.

Format

Ponteiro para uma estrutura de KS_DATAFORMAT_VIDEOINFOHEADER associada a esse fluxo.

Valor de retorno

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

Observações

Os minidrivers de câmera que devem manter a compatibilidade com versões anteriores com o USBCAMD original devem usar a estrutura USBCAMD_DEVICE_DATA e suas funções de retorno de chamada associadas (ou seja, funções de retorno de chamada que não contêm o sufixo "Ex").

O USBCAMD chama a função de retorno de chamada CamAllocateBandwidth do minidriver da câmera imediatamente antes do fluxo de captura de vídeo isocrono ser iniciado. Ele é chamado em conexão com um comando Executar.

Normalmente, essa função chama o serviço USBCAMD_SelectAlternateInterface para selecionar a interface alternativa correta e preparar-se para streaming de vídeo.

Essa função é necessária.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho usbcamdi.h (inclua Usbcamdi.h)

Consulte também

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface