USBD_BuildRegisterCompositeDevice函式 (usbdlib.h)
USBD_BuildRegisterCompositeDevice例程是由 USB 多函式裝置的驅動程式 (複合驅動程式) 呼叫,以使用向 USB 驅動程式堆疊註冊驅動程式所需的資訊,初始化REGISTER_COMPOSITE_DEVICE結構。
此例程是由取代 Microsoft 提供的複合驅動程式的驅動程式所呼叫,Usbccgp.sys。
語法
void USBD_BuildRegisterCompositeDevice(
[in] USBD_HANDLE USBDHandle,
[in] COMPOSITE_DEVICE_CAPABILITIES CapabilityFlags,
[in] ULONG FunctionCount,
[out] PREGISTER_COMPOSITE_DEVICE RegisterCompositeDevice
);
參數
[in] USBDHandle
在先前呼叫 USBD_CreateHandle 例程中擷取的USBD句柄。
[in] CapabilityFlags
呼叫端配置的 COMPOSITE_DEVICE_CAPABILITIES 結構,表示複合驅動程序支援的功能。 例如,若要指出複合驅動程序支援函式暫止,請將 COMPOSITE_DEVICE_CAPABILITIES的 CapabilityFunctionSuspend 成員設定為 1。
[in] FunctionCount
父驅動程式所建立的實體裝置物件數目 (PDO) 。 FunctionCount 值不能超過 255。
[out] RegisterCompositeDevice
呼叫端配置的 REGISTER_COMPOSITE_DEVICE 結構的指標。 完成時,結構會填入指定的註冊資訊。 若要註冊復合驅動程式,請傳送 IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE I/O 要求,並傳遞填入的結構。
傳回值
無
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 需要 WDK。 以 Windows Vista 和更新版本的 Windows 作業系統為目標。 |
目標平台 | 桌面 |
標頭 | usbdlib.h |
程式庫 | Usbdex.lib |
IRQL | < = DISPATCH_LEVEL |