Partilhar via


função de retorno de chamada PCAM_ALLOCATE_BW_ROUTINE (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 da 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 KS_DATAFORMAT_VIDEOINFOHEADER associada a esse fluxo.

Retornar valor

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

Comentários

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 que o fluxo de captura de vídeo isócrono seja 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 se preparar para streaming de vídeo.

Essa função é necessária.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho usbcamdi.h (inclua Usbcamdi.h)

Confira também

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface