ucxusbdevice.h 標頭

此標頭是用來寫入 USB 主機控制器驅動程式。 USB 主機控制器擴充功能是系統提供的驅動程式 (Ucx01000.sys) 。 此驅動程式是使用 Windows 驅動程式架構程式設計介面實作為架構類別延伸模組。 主機控制器驅動程式可作為該類別延伸模組的用戶端驅動程式。 雖然主機控制器驅動程式會處理硬體作業和事件、電源管理和 PnP 事件，但 UCX 可作為抽象介面，可將要求排入主機控制器驅動程式的佇列，並執行其他工作。

請勿直接包含此標頭。 請改為包含 Ucxclass.h

如需詳細資訊，請參閱

• 開發適用于 USB 主機控制器的 Windows 驅動程式
• 通用序列匯流排 (USB)

ucxusbdevice.h 包含下列程式設計介面：

函式

UCX_USBDEVICE_EVENT_CALLBACKS_INIT 使用用戶端驅動程式回呼函式的函式指標，初始化UCX_USBDEVICE_EVENT_CALLBACKS結構。
UcxUsbDeviceCreate 在指定的控制器上建立 USB 裝置物件。
UcxUsbDeviceInitSetEventCallbacks 使用用戶端驅動程式的事件回呼函式，初始化UCXUSBDEVICE_INIT結構。
UcxUsbDeviceRemoteWakeNotification 通知 UCX 收到來自裝置的遠端喚醒訊號。

回呼函式

EVT_UCX_USBDEVICE_ADDRESS 用戶端驅動程式的實作，UCX 呼叫以定址 USB 裝置。
EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD 用戶端驅動程式的實作，UCX 會呼叫 以新增 USB 裝置的新預設端點。
EVT_UCX_USBDEVICE_DISABLE 用戶端驅動程式的實作，UCX 會呼叫以釋放與裝置及其預設端點相關聯的控制器資源。
EVT_UCX_USBDEVICE_ENABLE 用戶端驅動程式的實作，UCX 會呼叫 UCX，以將裝置及其預設控制端點的相關資訊程式設計到控制器中。
EVT_UCX_USBDEVICE_ENDPOINT_ADD 用戶端驅動程式的實作，UCX 會呼叫 以新增 USB 裝置的新端點。
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE 用戶端驅動程式的實作，UCX 會呼叫 以在控制器中設定端點。
EVT_UCX_USBDEVICE_GET_CHARACTERISTIC UCX 會叫用此回呼來擷取裝置特性。
EVT_UCX_USBDEVICE_HUB_INFO 用戶端驅動程式的實作，UCX 會呼叫以擷取中樞屬性。
EVT_UCX_USBDEVICE_RESET 用戶端驅動程式的實作，UCX 會在裝置連接的埠重設時呼叫。
EVT_UCX_USBDEVICE_RESUME UCX 會叫用此回呼函式，以從暫停狀態繼續裝置。
EVT_UCX_USBDEVICE_SUSPEND UCX 會叫用此回呼函式來傳送裝置暫停狀態。
EVT_UCX_USBDEVICE_UPDATE UCX 呼叫以更新裝置屬性的用戶端驅動程式實作。

結構

ADDRESS0_OWNERSHIP_ACQUIRE 包含設定裝置的參數。
UCX_USBDEVICE_CHARACTERISTIC 儲存裝置的特性。
UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY 瞭解UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY如何儲存連續傳輸路徑延遲值。
UCX_USBDEVICE_EVENT_CALLBACKS 此結構提供 UCX USB 裝置事件回呼函式的清單。
UCXUSBDEVICE_INFO 包含 USB 裝置的相關資訊。 此結構是由 EVT_UCX_CONTROLLER_USBDEVICE_ADD 事件回呼函式中的 UCX 傳遞。
USB_DEVICE_PORT_PATH 包含 USB 裝置的埠路徑。
USBDEVICE_ABORTIO 包含用來中止資料傳輸的通用序列匯流排 (USB) 中樞或裝置的控制碼。
USBDEVICE_ADDRESS 包含將指定裝置轉換為已定址狀態的要求參數。 此結構是由要求參數中的 UCX 傳遞， (EVT_UCX_USBDEVICE_ADDRESS回呼函式之架構要求物件的 Parameters.Others.Arg1) 。
USBDEVICE_DISABLE 包含要停用指定裝置之要求的參數。 此結構是由要求參數中的 UCX 傳遞， (parameters.Others.Arg1) EVT_UCX_USBDEVICE_DISABLE回呼函式的架構要求物件。
USBDEVICE_ENABLE 包含啟用指定裝置之要求的參數。 此結構是由要求參數中的 UCX 傳遞， (Parameters.Others.Arg1) EVT_UCX_USBDEVICE_ENABLE回呼函式的架構要求物件。
USBDEVICE_ENABLE_FAILURE_FLAGS EVT_UCX_USBDEVICE_ENABLE回呼函式中用戶端驅動程式所設定的旗標。 指出啟用裝置時可能發生的錯誤。如果有的話。
USBDEVICE_HUB_INFO 包含要求的參數，以取得指定中樞的相關資訊。 此結構是由要求參數中的 UCX 傳遞， (parameters.Others.Arg1) EVT_UCX_USBDEVICE_HUB_INFO回呼函式的架構要求物件。
USBDEVICE_MGMT_HEADER 此結構提供通用序列匯流排 (USB) 中樞或實際連線到匯流排的裝置控制碼。
USBDEVICE_PURGEIO USBDEVICE_PURGEIO 結構包含通用序列匯流排 (USB) 中樞或裝置的控制碼，以清除 I/O。
USBDEVICE_RESET 包含重設指定裝置之要求的參數。 此結構是由要求參數中的 UCX 傳遞， (Parameters.Others.Arg1) EVT_UCX_USBDEVICE_RESET回呼函式的架構要求物件。
USBDEVICE_STARTIO 包含用來啟動資料傳輸之通用序列匯流排 (USB) 中樞或裝置的控制碼。
USBDEVICE_TREE_PURGEIO 此結構提供通用序列匯流排 (USB) 裝置樹狀結構的控制碼，以清除 I/O。
USBDEVICE_UPDATE 由 UCX 傳遞以更新指定的裝置。 這個結構位於 (Parameters.Others.Arg1 的要求參數中，) EVT_UCX_USBDEVICE_UPDATE回呼函式中傳遞的架構要求物件。
USBDEVICE_UPDATE_20_HARDWARE_LPM_PARAMETERS 包含要求更新 USB 2.0 連結電源管理 (LPM) 的參數。 UCX 會在EVT_UCX_USBDEVICE_UPDATE回呼函式中傳遞這個結構。
USBDEVICE_UPDATE_FAILURE_FLAGS 用戶端驅動程式在EVT_UCX_USBDEVICE_UPDATE回呼函式中設定的旗標。 指出更新裝置時可能發生的錯誤，如果有的話。
USBDEVICE_UPDATE_FLAGS 包含 UCX 所設定的要求旗標，此旗標會在 UCX 叫用用戶端驅動程式的EVT_UCX_USBDEVICE_UPDATE回呼函式時傳入USBDEVICE_UPDATE 結構中。

列舉

UCX_USBDEVICE_CHARACTERISTIC_TYPE 定義值，指出裝置特性的類型。
UCX_USBDEVICE_RECOVERY_ACTION 定義 FLDR 和 PLDR 觸發程式重設的值。