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 以降でサポートされています。 |
| Header | ntddser.h (Ntddser.h を含む) |