IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION 制御コードは、シリアル コントローラー デバイスの既定のハードウェア設定を使用するようにシリアル ポートを構成します。 これらの設定は、シリアル コントローラー デバイスの ACPI リソース記述子から取得されます。 詳細については、ACPI 5.0 仕様を参照してください。
メジャー コード
入力バッファー
何一つ。
入力バッファーの長さ
何一つ。
出力バッファー
何一つ。
出力バッファーの長さ
何一つ。
状態ブロック
Information メンバーは 0 に設定されます。
Status メンバーは、シリアル デバイス制御要求 の汎用状態値のいずれかに設定されます。 STATUS_NOT_IMPLEMENTEDの状態は、シリアル ポートが既定の構成をサポートしていないことを示します。 この場合、クライアントは、他の IOCTL_SERIAL_XXX I/O 制御要求を使用して、シリアル ポートを明示的に構成する必要があります。
備考
クライアント (アプリケーションまたは周辺機器ドライバー) は、この IOCTL を送信して、一連の既定の接続設定を使用するようにシリアル ポートを構成します。 これらの設定には、ボー レート、タイムアウト値、フロー制御フラグなどの接続固有のハードウェア パラメーターが含まれます。
この IOCTL は、シリアル フレームワーク拡張機能 (SerCx および SerCx2) のバージョン 1 および 2 でサポートされています。 pc 上の名前付きシリアル ポート (COM1、COM2 など) を管理する Serial.sysは、この IOCTL をサポートしていません。
シリアル ポートがこの IOCTL をサポートしていない場合、クライアントはポートの接続設定を明示的に指定する必要があります。 つまり、クライアントはボー レートを設定する IOCTL_SERIAL_SET_BAUD_RATE 要求を送信し、タイムアウト間隔を設定する IOCTL_SERIAL_SET_TIMEOUTS 要求を送信する必要があります。
クライアントがシリアル ポートを開いた直後に、クライアントはポートが既知の既定の状態ではなく、未知の初期化されていない状態で構成されていると想定する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降でサポートされています。 |
| ヘッダー | ntddser.h (Ntddser.h を含む) |