funzione USBD_BuildRegisterCompositeDevice (usbdlib.h)

La routine USBD_BuildRegisterCompositeDevice viene chiamata dal driver di un dispositivo a più funzioni USB (driver composito) per inizializzare una struttura REGISTER_COMPOSITE_DEVICE con le informazioni necessarie per registrare il driver con lo stack di driver USB.

La routine viene chiamata da un driver che sostituisce il driver composito fornito da Microsoft, Usbccgp.sys.

Sintassi

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

Parametri

[in] USBDHandle

Handle USBD recuperato in una chiamata precedente alla routine USBD_CreateHandle .

[in] CapabilityFlags

Struttura COMPOSITE_DEVICE_CAPABILITIES allocata dal chiamante che indica le funzionalità supportate dal driver composito. Ad esempio, per indicare che il driver composito supporta la sospensione della funzione, impostare il membro CapabilityFunctionSuspend di COMPOSITE_DEVICE_CAPABILITIES su 1.

[in] FunctionCount

Numero di oggetti dispositivo fisico (PDO) da creare dal driver padre. Il valore FunctionCount non può superare 255.

[out] RegisterCompositeDevice

Puntatore a una struttura REGISTER_COMPOSITE_DEVICE allocata dal chiamante. Al termine, la struttura viene popolata con le informazioni di registrazione specificate. Per registrare il driver composito, inviare la richiesta di I/O IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE e passare la struttura popolata.

Valore restituito

nessuno

Requisiti

Requisito	Valore
Client minimo supportato	Richiede WDK per Windows 8. È destinato a Windows Vista e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Desktop
Intestazione	usbdlib.h
Libreria	Usbdex.lib
IRQL	< = DISPATCH_LEVEL

Vedi anche

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE