ucxusbdevice.h ヘッダー
このヘッダーは、USB ホスト コントローラー ドライバーを記述するために使用されます。 USB ホスト コントローラー拡張機能は、システム提供のドライバー (Ucx01000.sys)。 このドライバーは、Windows Driver Framework プログラミング インターフェイスを使用してフレームワーク クラス拡張機能として実装されます。 ホスト コントローラー ドライバーは、そのクラス拡張機能のクライアント ドライバーとして機能します。 ホスト コントローラー ドライバーはハードウェアの操作とイベント、電源管理、PnP イベントを処理しますが、UCX は、ホスト コントローラー ドライバーへの要求をキューに入れ、その他のタスクを実行する抽象化されたインターフェイスとして機能します。
このヘッダーを直接含めないでください。 代わりに Ucxclass.h を含めます
詳細については、次を参照してください。
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 がデバイスとその既定の制御エンドポイントに関するプログラム情報をコントローラーに呼び出すクライアント ドライバーの実装。 |
| 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 指定したデバイスを Addressed 状態に移行するための要求のパラメーターが含まれます。 この構造体は、EVT_UCX_USBDEVICE_ADDRESS コールバック関数のフレームワーク要求オブジェクトの要求パラメーター (Parameters.Others.Arg1) で UCX によって渡されます。 |
| USBDEVICE_DISABLE 指定したデバイスを無効にする要求のパラメーターが含まれます。 この構造体は、EVT_UCX_USBDEVICE_DISABLE コールバック関数のフレームワーク要求オブジェクトの要求パラメーター (Parameters.Others.Arg1) で UCX によって渡されます。 |
| USBDEVICE_ENABLE 指定したデバイスを有効にする要求のパラメーターが含まれます。 この構造体は、EVT_UCX_USBDEVICE_ENABLE コールバック関数のフレームワーク要求オブジェクトの要求パラメーター (Parameters.Others.Arg1) で UCX によって渡されます。 |
| USBDEVICE_ENABLE_FAILURE_FLAGS EVT_UCX_USBDEVICE_ENABLE コールバック関数でクライアント ドライバーによって設定されるフラグ。 デバイスの有効化中に発生した可能性のあるエラー (存在する場合) を示します。 |
| USBDEVICE_HUB_INFO 指定したハブに関する情報を取得する要求のパラメーターを格納します。 この構造体は、EVT_UCX_USBDEVICE_HUB_INFO コールバック関数のフレームワーク要求オブジェクトの要求パラメーター (Parameters.Others.Arg1) で UCX によって渡されます。 |
| USBDEVICE_MGMT_HEADER この構造体は、バスに物理的に接続されているユニバーサル シリアル バス (USB) ハブまたはデバイスのハンドルを提供します。 |
| USBDEVICE_PURGEIO USBDEVICE_PURGEIO構造体には、I/O を消去するユニバーサル シリアル バス (USB) ハブまたはデバイスのハンドルが含まれています。 |
| USBDEVICE_RESET 指定したデバイスをリセットする要求のパラメーターが含まれます。 この構造体は、EVT_UCX_USBDEVICE_RESET コールバック関数のフレームワーク要求オブジェクトの要求パラメーター (Parameters.Others.Arg1) で UCX によって渡されます。 |
| USBDEVICE_STARTIO データ転送を開始するユニバーサル シリアル バス (USB) ハブまたはデバイスのハンドルが含まれています。 |
| USBDEVICE_TREE_PURGEIO この構造体は、I/O を消去するユニバーサル シリアル バス (USB) デバイス ツリーのハンドルを提供します。 |
| USBDEVICE_UPDATE 指定したデバイスを更新するために UCX によって渡されます。 この構造体は、EVT_UCX_USBDEVICE_UPDATE コールバック関数で渡されたフレームワーク要求オブジェクトの要求パラメーター (Parameters.Others.Arg1) にあります。 |
| 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 がクライアント ドライバーのEVT_UCX_USBDEVICE_UPDATE コールバック関数を呼び出すときにUSBDEVICE_UPDATE構造体で渡される UCX によって設定された要求フラグが含まれます。 |
列挙
| UCX_USBDEVICE_CHARACTERISTIC_TYPE デバイス特性の種類を示す値を定義します。 |
| UCX_USBDEVICE_RECOVERY_ACTION FLDR および PLDR トリガーのリセットの値を定義します。 |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示