IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION控制程式代碼會將串行埠設定為使用序列控制器裝置的預設硬體設定。 這些設定是從序列控制器裝置的 ACPI 資源描述項取得。 如需詳細資訊,請參閱 ACPI 5.0 規格。
主要程序代碼
輸入緩衝區
無。
輸入緩衝區長度
無。
輸出緩衝區
無。
輸出緩衝區長度
無。
狀態區塊
Information 成員設定為零。
Status 成員會設定為序列設備控制要求的其中一個一般狀態值。 STATUS_NOT_IMPLEMENTED的狀態表示串行埠不支援預設設定。 在此情況下,客戶端必須使用其他 IOCTL_SERIAL_XXX I/O 控制要求來明確設定串行埠。
備註
用戶端 (應用程式或周邊設備驅動器) 傳送此 IOCTL 來設定序列埠,以使用一組默認連線設定。 這些設定包括連線特定的硬體參數,例如傳輸速率、逾時值和流程控制旗標。
此 IOCTL 支援序列架構延伸模組第 1 版和第 2 版, (SerCx 和 SerCx2) 。 Serial.sys 管理計算機上 (COM1、COM2 等) 的具名串行埠,不支援此 IOCTL。
如果序列埠不支援此 IOCTL,客戶端必須明確指定埠的連線設定。 也就是說,客戶端必須傳送 IOCTL_SERIAL_SET_BAUD_RATE 要求以設定傳輸速率、傳送 IOCTL_SERIAL_SET_TIMEOUTS 要求來設定超時時間間隔等等。
在客戶端開啟序列埠之後,客戶端應該假設埠設定為未知、未初始化的狀態,而不是在某些已知默認狀態中。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始支援。 |
標頭 | ntddser.h (包含 Ntddser.h) |