共用方式為

USB 函式用戶端驅動程式所使用的UFX物件和句柄

  • 發行項

UFX) UFX (USB 函式類別延伸模組會使用 WDF 物件功能來定義這些 USB 特定的 UFX 物件。

摘要

  • 函式控制器驅動程式會使用UFX對象來處理往返端點的傳輸。
  • 這些物件是 WDF 物件的句柄，並由 UFX 在用戶端驅動程式的要求建立。 每個物件的存留期都是由UFX管理。

重要 API

UFX) UFX (USB 函式類別延伸模組會使用 WDF 物件功能來定義這些 USB 特定的 UFX 物件。

這些物件是WDF物件的句柄，而且是由UFX在函式用戶端驅動程式的要求建立。 選擇性地，客戶端驅動程式可以將內容與建立時傳遞的這些對象產生關聯。 UFX 建立的每個 WDF 物件可能都有兩個裝置內容：一個裝置內容會在物件建立時由 UFX 設定;用戶端驅動程式傳入的其他裝置內容，並在建立 WDF 對象之後，使用 WdfObjectAllocateContext 在 UFX 中設定。

UFXDEVICE：USB 裝置物件

代表控制器所建立的USB裝置。 對象負責根據 USB 通訊協定規格管理 USB 狀態，以及管理與 USB 裝置相關聯的一或多個端點。 函式控制器驅動程式會藉由呼叫 UfxDeviceCreate 方法，在 EvtDriverDeviceAdd 回呼內建立此物件。


EVT_UFX_DEVICE_HOST_CONNECT起始與主機的連線。


EVT_UFX_DEVICE_HOST_DISCONNECT停用函式控制器與主機的通訊。


EVT_UFX_DEVICE_ADDRESSED指派函式控制器上的位址。


EVT_UFX_DEVICE_ENDPOINT_ADD建立預設端點物件。


EVT_UFX_DEVICE_DEFAULT_ENDPOINT_ADD建立預設端點物件。


EVT_UFX_DEVICE_USB_STATE_CHANGE更新USB裝置的狀態。


EVT_UFX_DEVICE_PORT_CHANGE更新 USB 裝置所連線的新埠類型。


EVT_UFX_DEVICE_PORT_DETECT起始埠偵測。


EVT_UFX_DEVICE_REMOTE_WAKEUP_SIGNAL在函式控制器上起始遠程喚醒。


EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER起始專屬的濕度偵測。


EVT_UFX_DEVICE_PROPRIETARY_CHARGER_RESET重設專屬的電池。


EVT_UFX_DEVICE_PROPRIETARY_CHARGER_SET_PROPERTY設定它用來透過 USB 充電的充電資訊。

UFXENDPOINT：USB 端點物件

表示主機與裝置之間的邏輯連線。 對象負責將數據傳送至主機或從主機傳送。 針對每個裝置物件，可以有一或多個端點。 默認端點一律是控制端點，而 rest 則是類別驅動程式特定物件。 函式控制器驅動程式會呼叫 UfxEndpointCreate 方法，在EVT_UFX_DEVICE_ENDPOINT_ADD回呼中建立 物件。