función USBD_BuildRegisterCompositeDevice (usbdlib.h)

Artículo
02/26/2024

El controlador de un dispositivo usb de varias funciones (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 la función, establezca el miembro CapabilityFunctionSuspend 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

None

Requisitos

Requisito	Value
Cliente mínimo compatible	Requiere WDK para Windows 8. Tiene como destino Windows Vista y versiones posteriores del sistema operativo Windows.
Plataforma de destino	Escritorio
Encabezado	usbdlib.h
Library	Usbdex.lib
IRQL	< = DISPATCH_LEVEL

Consulte también

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE

Share via