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

Artigo
02/29/2024

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

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

Sintaxe

PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;

NTSTATUS PcamConfigureRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  PLONG DataPipeIndex,
  PLONG SyncPipeIndex
)
{...}

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 uma 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 um USB_CONFIGURATION_DESCRIPTOR inicializado para este dispositivo.

DataPipeIndex

Ponteiro para um valor que indica o índice do pipe de dados. O minidriver da câmera deve preencher esse valor antes de retornar.

SyncPipeIndex

Ponteiro para um valor que indica o índice do pipe de sincronização, se for necessário. O minidriver da câmera deve preencher esse valor antes de retornar.

Retornar valor

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

Comentários

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 CamConfigure do minidriver da câmera 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.

Essa função é necessária.