usbioctl.h ヘッダー
このヘッダーは usbref によって使用されます。 詳細については、次を参照してください。
usbioctl.h には、次のプログラミング インターフェイスが含まれています。
IOCTL
IOCTL_GET_HCD_DRIVERKEY_NAME IOCTL_GET_HCD_DRIVERKEY_NAME I/O 制御要求は、USB ホスト コントローラー ドライバーのレジストリ内のドライバー キー名を取得します。 |
IOCTL_INTERNAL_USB_CYCLE_PORT IOCTL_INTERNAL_USB_CYCLE_PORT I/O 要求は、PDO に関連付けられているポートでデバイスの取り外しと再プラグをシミュレートします。 |
IOCTL_INTERNAL_USB_ENABLE_PORT IOCTL_INTERNAL_USB_ENABLE_PORT IOCTL は非推奨となりました。 使用しないでください。 |
IOCTL_INTERNAL_USB_GET_BUS_INFO IOCTL_INTERNAL_USB_GET_BUS_INFO I/O 要求は、バス ドライバーに特定のバス情報を照会します。 |
IOCTL_INTERNAL_USB_GET_BUSGUID_INFO IOCTL_INTERNAL_USB_GET_BUSGUID_INFO IOCTL は非推奨となりました。 使用しないでください。 |
IOCTL_INTERNAL_USB_GET_CONTROLLER_NAME IOCTL_INTERNAL_USB_GET_CONTROLLER_NAME I/O 要求は、USB ホスト コントローラーのデバイス名をバス ドライバーに照会します。 |
IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO I/O 要求は、USB デバイスと接続されているハブに関する情報を返します。 |
IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE_EX IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE_EX IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_GET_HUB_COUNT IOCTL_INTERNAL_USB_GET_HUB_COUNT IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL_INTERNAL_USB_GET_HUB_NAME I/O 要求は、PDO がハブの場合、ターゲット PDO の UNICODE シンボリック名を取得するためにドライバーによって使用されます。 |
IOCTL_INTERNAL_USB_GET_PARENT_HUB_INFO IOCTL_INTERNAL_USB_GET_PARENT_HUB_INFOは、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_GET_PORT_STATUS IOCTL_INTERNAL_USB_GET_PORT_STATUS I/O 要求は、PDO の状態を照会します。 IOCTL_INTERNAL_USB_GET_PORT_STATUSは、カーネル モードの I/O 制御要求です。 この要求は、USB ハブ PDO を対象とします。 この IOCTL は IRQL = PASSIVE_LEVELで送信する必要があります。 |
IOCTL_INTERNAL_USB_GET_ROOTHUB_PDO IOCTL_INTERNAL_USB_GET_ROOTHUB_PDO IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS I/O 要求は、USB デバイスが接続されているホスト コントローラーと、USB デバイス ツリー内のデバイスの場所に関する情報を返します。 |
IOCTL_INTERNAL_USB_GET_TT_DEVICE_HANDLE IOCTL_INTERNAL_USB_GET_TT_DEVICE_HANDLEは、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_NOTIFY_IDLE_READY IOCTL_INTERNAL_USB_NOTIFY_IDLE_READY IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_RECORD_FAILURE IOCTL_INTERNAL_USB_RECORD_FAILURE IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE I/O 要求は、USB 多機能デバイス (複合ドライバー) のドライバーを基になる USB ドライバー スタックに登録します。 |
IOCTL_INTERNAL_USB_REQ_GLOBAL_RESUME IOCTL_INTERNAL_USB_REQ_GLOBAL_RESUME IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_REQ_GLOBAL_SUSPEND IOCTL_INTERNAL_USB_REQ_GLOBAL_SUSPEND IOCTL は、USB ハブ ドライバーによって使用されます。 使用しないでください。 |
IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION I/O 要求は、ユニバーサル シリアル バス (USB) 多機能デバイス (複合ドライバー) のドライバーによって送信され、デバイス内の特定の関数からリモート ウェイクアップ通知を要求します。 |
IOCTL_INTERNAL_USB_RESET_PORT IOCTL_INTERNAL_USB_RESET_PORT I/O 制御要求は、ドライバーが管理するデバイスのアップストリーム ポートをリセットするために使用されます。 |
IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION I/O 要求は、デバイスがアイドル状態であり、中断できることを USB バス ドライバーに通知するためにドライバーによって使用されます。 |
IOCTL_INTERNAL_USB_SUBMIT_URB IOCTL_INTERNAL_USB_SUBMIT_URB I/O 制御要求は、ドライバーがバス ドライバーに URB を送信するために使用されます。 IOCTL_INTERNAL_USB_SUBMIT_URBは、カーネル モードの I/O 制御要求です。 この要求は、USB ハブ PDO を対象とします。 |
IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE I/O 要求は、USB 多機能デバイス (複合ドライバー) のドライバーの登録を解除し、登録に関連付けられているすべてのリソースを解放します。 |
IOCTL_USB_DIAG_IGNORE_HUBS_OFF IOCTL_USB_DIAG_IGNORE_HUBS_OFF I/O コントロールは非推奨となりました。 使用しないでください。 |
IOCTL_USB_DIAG_IGNORE_HUBS_ON IOCTL_USB_DIAG_IGNORE_HUBS_ON I/O コントロールは非推奨になりました。 使用しないでください。 |
IOCTL_USB_DIAGNOSTIC_MODE_OFF IOCTL_USB_DIAGNOSTIC_MODE_OFF I/O コントロールは非推奨となりました。 使用しないでください。 |
IOCTL_USB_DIAGNOSTIC_MODE_ON IOCTL_USB_DIAGNOSTIC_MODE_ON I/O コントロールは非推奨になりました。 使用しないでください。 |
IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION I/O 制御要求は、指定されたポート インデックスに関連付けられているデバイスの 1 つ以上の記述子を取得します。IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTIONは、ユーザー モードの I/O 制御要求です。 |
IOCTL_USB_GET_DEVICE_CHARACTERISTICS クライアント ドライバーは、USB デバイスに関する一般的な特性 (要求の最大送受信遅延など) を決定するために、この要求を送信します。 |
IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC IOCTL 関数は、特定のフレームとマイクロフレームのシステム クエリ パフォーマンス カウンター (QPC) 値を取得します。 |
IOCTL_USB_GET_HUB_CAPABILITIES IOCTL_USB_GET_HUB_CAPABILITIES I/O 制御要求は、USB ハブの機能を取得します。 |
IOCTL_USB_GET_HUB_CAPABILITIES_EX IOCTL_USB_GET_HUB_CAPABILITIES_EX I/O 制御要求は、USB ハブの機能を取得します。IOCTL_USB_GET_HUB_CAPABILITIES_EXは、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象とします。 |
IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL_USB_GET_HUB_INFORMATION_EX I/O 制御要求は、USB_HUB_INFORMATION_EX構造体内の USB ハブに関する情報を取得するために、アプリケーションによって送信されます。要求は、ハブ上で最も大きいポート番号を取得します。 |
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O 制御要求は、特定のポートの Microsoft 拡張ポート属性を取得します。 |
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME I/O 制御要求は、指定されたポートに接続されているデバイスに関連付けられているドライバー レジストリ キー名を取得します。 |
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL_USB_GET_NODE_CONNECTION_INFORMATION要求は、指定された USB ポートとポートに接続されているデバイスに関する情報を取得します (存在する場合)。クライアント ドライバーは、PASSIVE_LEVELの IRQL でこの IOCTL を送信する必要があります。IOCTL_USB_GET_NODE_CONNECTION_INFORMATIONは、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象とします。 この要求をルート ハブに送信しないでください。 |
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX要求は、USB ポートと、ポートに接続されているデバイスに関する情報 (存在する場合) を取得します。クライアント ドライバーは、PASSIVE_LEVELの IRQL でこの IOCTL を送信する必要があります。IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EXは、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象とします。 この要求をルート ハブに送信しないでください。 |
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 I/O コントロールは、ハブ上の特定の USB ポートでサポートされているプロトコルに関する情報を取得するために、アプリケーションによって送信されます。 要求は、ポートの速度機能も取得します。 |
IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 制御要求は、ダウンストリーム ポートに接続されているハブのシンボリック リンク名を取得するために、USB_NODE_CONNECTION_NAME構造体と共に使用されます。IOCTL_USB_GET_NODE_CONNECTION_NAMEは、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象とします。 |
IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION |
IOCTL_USB_GET_NODE_INFORMATION IOCTL_USB_GET_NODE_INFORMATION I/O 制御要求は、親デバイスに関する情報を取得するために、USB_NODE_INFORMATION構造体と共に使用されます。IOCTL_USB_GET_NODE_INFORMATIONは、ユーザー モードの I/O 制御要求です。 |
IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES I/O 制御要求は、USB ハブ上の特定のポートに関する情報を取得するために、アプリケーションによって送信されます。 |
IOCTL_USB_GET_ROOT_HUB_NAME IOCTL_USB_GET_ROOT_HUB_NAME I/O 制御要求は、ルート ハブのシンボリック リンク名を取得するために、USB_ROOT_HUB_NAME構造体と共に使用されます。IOCTL_USB_GET_ROOT_HUB_NAMEは、ユーザー モードの I/O 制御要求です。 |
IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS クライアント ドライバーは、トランスポート特性を取得するためにこの要求を送信します。 |
IOCTL_USB_HCD_DISABLE_PORT IOCTL_USB_HCD_DISABLE_PORT IOCTL は非推奨となりました。 使用しないでください。 |
IOCTL_USB_HCD_ENABLE_PORT IOCTL_USB_HCD_ENABLE_PORT IOCTL は非推奨となりました。 使用しないでください。 |
IOCTL_USB_HCD_GET_STATS_1 IOCTL_USB_HCD_GET_STATS_1 IOCTL は非推奨となりました。 使用しないでください。 |
IOCTL_USB_HCD_GET_STATS_2 IOCTL_USB_HCD_GET_STATS_2 IOCTL は非推奨となりました。 使用しないでください。 |
IOCTL_USB_HUB_CYCLE_PORT IOCTL_USB_HUB_CYCLE_PORT I/O 制御要求は、要求を受信する PDO に関連付けられているポートを電源サイクルします。 |
IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE この要求は、トランスポート特性の変更を呼び出し元に通知します。 |
IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE この要求は、トランスポート特性の変更に関する通知に登録されます。 |
IOCTL_USB_RESET_HUB IOCTL_USB_RESET_HUB IOCTL は、USB ドライバー スタックによって使用されます。 使用しないでください。 |
IOCTL_USB_START_TRACKING_FOR_TIME_SYNC この要求により、呼び出し元が時刻同期サービスの USB ドライバー スタックに登録されます。 |
IOCTL_USB_STOP_TRACKING_FOR_TIME_SYNC この要求は、時間同期サービスの USB ドライバー スタックで呼び出し元の登録を解除します。 |
IOCTL_USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE この要求により、トランスポート特性の変更に関する通知を呼び出し元が取得できなくなります。 |
構造
HUB_DEVICE_CONFIG_INFO HUB_DEVICE_CONFIG_INFO構造体は、カーネル モード IOCTL と組み合わせて使用IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO、USB デバイスとデバイスが接続されているハブに関する情報を報告するように要求します。 |
USB_BUS_NOTIFICATION 詳細情報: _USB_BUS_NOTIFICATION構造体 |
USB_CYCLE_PORT_PARAMS USB_CYCLE_PORT_PARAMS構造体は、IOCTL_USB_HUB_CYCLE_PORT I/O 制御要求と共に使用され、要求を受け取る PDO に関連付けられているポートを電源サイクルします。 |
USB_DESCRIPTOR_REQUEST USB_DESCRIPTOR_REQUEST構造体は、指定された接続インデックスに関連付けられているデバイスの 1 つ以上の記述子を取得するために、IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION I/O 制御要求と共に使用されます。 |
USB_DEVICE_CHARACTERISTICS 要求の最大送受信遅延など、USB デバイスの特性に関する情報が含まれます。 この構造体は、IOCTL_USB_GET_DEVICE_CHARACTERISTICS要求で使用されます。 |
USB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION フレーム番号とマイクロフレーム番号、および計算されたシステム QPC 値を格納します。 この構造体は、IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC要求で使用されます。 |
USB_HCD_DRIVERKEY_NAME USB_HCD_DRIVERKEY_NAME構造体は、USB ホスト コントローラー ドライバーのレジストリ内のドライバー キーを取得するために、IOCTL_GET_HCD_DRIVERKEY_NAME I/O 制御要求と共に使用されます。 |
USB_HUB_CAP_FLAGS USB_HUB_CAP_FLAGS構造は、ハブの機能を報告するために使用されます。 |
USB_HUB_CAPABILITIES USB_HUB_CAPABILITIES構造体は非推奨となりました。 代わりに USB_HUB_CAPABILITIES_EX を使用してください。 |
USB_HUB_CAPABILITIES_EX USB_HUB_CAPABILITIES_EX構造体は、特定の USB ハブの機能を取得するために、IOCTL_USB_GET_HUB_CAPABILITIES I/O 制御要求と共に使用されます。 |
USB_HUB_INFORMATION USB_HUB_INFORMATION構造体には、ハブに関する情報が含まれています。 |
USB_HUB_INFORMATION_EX USB_HUB_INFORMATION_EX構造体は、ユニバーサル シリアル バス (USB) ハブに関する情報を取得するために、IOCTL_USB_GET_HUB_INFORMATION_EX I/O 制御要求と共に使用されます。 |
USB_HUB_NAME USB_HUB_NAME構造体には、ハブのシンボリック デバイス名が格納されます。 |
USB_ID_STRING USB_ID_STRING構造体は、文字列または複数の文字列を格納するために使用されます。 |
USB_MI_PARENT_INFORMATION USB_MI_PARENT_INFORMATION構造体には、複合デバイスに関する情報が含まれています。 |
USB_NODE_CONNECTION_ATTRIBUTES USB_NODE_CONNECTION_ATTRIBUTES構造体は、接続の属性を取得するために、IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O 制御要求と共に使用されます。 |
USB_NODE_CONNECTION_DRIVERKEY_NAME USB_NODE_CONNECTION_DRIVERKEY_NAME構造体は、指定されたポートに接続されているデバイスのドライバー キー名を取得するために、IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME I/O 制御要求と共に使用されます。 |
USB_NODE_CONNECTION_INFORMATION USB_NODE_CONNECTION_INFORMATION構造体は、USB ポートと接続されているデバイスに関する情報を取得するために、IOCTL_USB_GET_NODE_CONNECTION_INFORMATION要求と共に使用されます。 |
USB_NODE_CONNECTION_INFORMATION_EX USB_NODE_CONNECTION_INFORMATION_EX構造体は、指定された USB ポートに関連付けられている接続に関する情報を取得するために、IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX要求と組み合わせて使用されます。 |
USB_NODE_CONNECTION_INFORMATION_EX_V2 USB_NODE_CONNECTION_INFORMATION_EX_V2構造体は、特定のポートに接続されているユニバーサル シリアル バス (USB) デバイスに関する速度情報を取得するために、IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 I/O 制御要求と共に使用されます。 |
USB_NODE_CONNECTION_INFORMATION_EX_V2_FLAGS USB_NODE_CONNECTION_INFORMATION_EX_V2_FLAGS共用体は、USB 3.0 デバイスが現在動作している速度と、特定のポートに接続されている場合に高速で動作できるかどうかを示すために使用されます。 |
USB_NODE_CONNECTION_NAME USB_NODE_CONNECTION_NAME構造体は、ポートに接続されているダウンストリーム ハブのシンボリック リンクを取得するために、IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 制御要求と共に使用されます。 |
USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION |
USB_NODE_INFORMATION USB_NODE_INFORMATION構造体は、親デバイスに関する情報を取得するために、IOCTL_USB_GET_NODE_INFORMATION I/O 制御要求と共に使用されます。 |
USB_PIPE_INFO USB_PIPE_INFO構造体は、USB_NODE_CONNECTION_INFORMATION_EX構造体とIOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX要求と組み合わせて使用され、接続とそれに関連付けられているパイプに関する情報を取得します。 |
USB_PORT_CONNECTOR_PROPERTIES USB_PORT_CONNECTOR_PROPERTIES構造体は、特定の SuperSpeed ハブ上のポートに関する情報を取得するために、IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES I/O 制御要求と共に使用されます。 |
USB_PORT_PROPERTIES USB_PORT_PROPERTIES共用体は、ユニバーサル シリアル バス (USB) ポートの機能を報告するために使用されます。ポート機能は、IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES I/O 制御要求によってUSB_PORT_CONNECTOR_PROPERTIES構造で取得されます。 |
USB_PROTOCOLS USB_PROTOCOLS共用体は、ポートでサポートされているユニバーサル シリアル バス (USB) シグナリング プロトコルを報告するために使用されます。 |
USB_ROOT_HUB_NAME USB_ROOT_HUB_NAME構造体には、ルート ハブのシンボリック デバイス名が格納されます。 |
USB_START_TRACKING_FOR_TIME_SYNC_INFORMATION IOCTL_USB_START_TRACKING_FOR_TIME_SYNC要求の入力バッファーと出力バッファー。 |
USB_STOP_TRACKING_FOR_TIME_SYNC_INFORMATION IOCTL_USB_STOP_TRACKING_FOR_TIME_SYNC要求の入力バッファー。 |
USB_TOPOLOGY_ADDRESS USB_TOPOLOGY_ADDRESS構造体は、USB デバイス ツリー内の USB デバイスの場所に関する情報を取得するために、IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS I/O 要求と共に使用されます。 |
USB_TRANSPORT_CHARACTERISTICS 輸送特性を関連する時点に格納します。 この構造体は、IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS要求で使用されます。 |
USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE要求の完了時に入力された登録情報が含まれます。 |
USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE要求の登録情報が含まれます。 |
USB_TRANSPORT_CHARACTERISTICS_CHANGE_UNREGISTRATION IOCTL_USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE要求の登録解除情報が含まれます。 |
列挙
USB_CONNECTION_STATUS USB_CONNECTION_STATUS列挙子は、USB ハブ ポート上のデバイスへの接続の状態を示します。 |
USB_HUB_NODE USB_HUB_NODE列挙子は、デバイスがハブか複合デバイスかを示します。 |
USB_HUB_TYPE USB_HUB_TYPE列挙は、USB ハブの種類を示す定数を定義します。 ハブの種類は、IOCTL_USB_GET_HUB_INFORMATION_EX I/O 制御要求によって取得されます。 |
USB_NOTIFICATION_TYPE 詳細情報: _USB_NOTIFICATION_TYPE列挙 |