función USBD_BuildRegisterCompositeDevice (usbdlib.h)

El controlador de un dispositivo usb multifunción (controlador compuesto) llama a la rutina USBD_BuildRegisterCompositeDevice para inicializar una estructura de REGISTER_COMPOSITE_DEVICE con la información necesaria para registrar el controlador con la pila del controlador USB.

Un controlador llama a la rutina que reemplaza al controlador compuesto proporcionado por Microsoft, Usbccgp.sys.

Sintaxis

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

Parámetros

[in] USBDHandle

Identificador USBD que se recupera en una llamada anterior a la rutina USBD_CreateHandle.

[in] CapabilityFlags

Estructura de COMPOSITE_DEVICE_CAPABILITIES asignada por el autor de la llamada que indica las funcionalidades admitidas por el controlador compuesto. Por ejemplo, para indicar que el controlador compuesto admite la suspensión de funciones, establezca el CapabilityFunctionSuspend miembro de COMPOSITE_DEVICE_CAPABILITIES en 1.

[in] FunctionCount

Número de objetos de dispositivo físico (PPO) que va a crear el controlador primario. El valor FunctionCount no puede superar los 255.

[out] RegisterCompositeDevice

Puntero a una estructura de REGISTER_COMPOSITE_DEVICE asignada por el autor de la llamada. Tras la finalización, la estructura se rellena con la información de registro especificada. Para registrar el controlador compuesto, envíe el IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE solicitud de E/S y pase la estructura rellenada.

Valor devuelto

Ninguno

Requisitos

Consulte también

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE