Função USBD_BuildRegisterCompositeDevice (usbdlib.h)

A rotina USBD_BuildRegisterCompositeDevice é chamada pelo driver de um dispositivo usb de várias funções (driver composto) para inicializar uma estrutura REGISTER_COMPOSITE_DEVICE com as informações necessárias para registrar o driver com a pilha do driver USB.

A rotina é chamada por um driver que substitui o driver composto fornecido pela Microsoft, Usbccgp.sys.

Sintaxe

void USBD_BuildRegisterCompositeDevice(
  [in]  USBD_HANDLE                   USBDHandle,
  [in]  COMPOSITE_DEVICE_CAPABILITIES CapabilityFlags,
  [in]  ULONG                         FunctionCount,
  [out] PREGISTER_COMPOSITE_DEVICE    RegisterCompositeDevice
);

Parâmetros

[in] USBDHandle

Um identificador USBD recuperado em uma chamada anterior para a rotina de USBD_CreateHandle .

[in] CapabilityFlags

Uma estrutura de COMPOSITE_DEVICE_CAPABILITIES alocada pelo chamador que indica os recursos compatíveis com o driver composto. Por exemplo, para indicar que o driver composto dá suporte à suspensão da função, defina o membro CapabilityFunctionSuspend de COMPOSITE_DEVICE_CAPABILITIES como 1.

[in] FunctionCount

O número de PDOs (objetos de dispositivo físico) a serem criados pelo driver pai. O valor FunctionCount não pode exceder 255.

[out] RegisterCompositeDevice

Um ponteiro para uma estrutura de REGISTER_COMPOSITE_DEVICE alocada pelo chamador. Após a conclusão, a estrutura é preenchida com as informações de registro especificadas. Para registrar o driver composto, envie a solicitação de E/S IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE e passe a estrutura preenchida.

Retornar valor

Nenhum

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Requer WDK para Windows 8. Tem como destino o Windows Vista e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	usbdlib.h
Biblioteca	Usbdex.lib
IRQL	< = DISPATCH_LEVEL

Confira também

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE