ASYNC EXTGETBAUDRATE: Difference between revisions

Latest revision as of 18:40, 22 October 2021

This function returns the extended query bit rate in doublewords for a bit rate higher than 19200 bps.

Category: IOCTL_ASYNC (01h)
Function: ASYNC_EXTGETBAUDRATE (63h)

Parameter Packet Format

None. Packet pointer must be NULL.

Data Packet Format

Field	Length	C Datatype
Current Bit Rate	DWORD	ULONG
Fraction of Current Bit Rate	BYTE	UCHAR
Minimum Bit Rate Supported	DWORD	ULONG
Fraction of Minimum Bit Rate Supported	BYTE	UCHAR
Maximum Bit Rate Supported	DWORD	ULONG
Fraction of Maximum Bit Rate Supported	BYTE	UCHAR

Current Bit Rate: The binary integer representing the actual bit rate in bits-per-seconds set for a COM port.
Fraction of Current Bit Rate: The binary integer representing the fraction of the actual current bit rate set for a COM port.
Minimum Bit Rate Supported: The binary integer representing the minimum bit rate (in bits-per-second) port for a COM port.
Maximum Bit Rate Supported: The binary integer representing the maximum bit rate (in bits-per-second) supported for a COM port. Depending on overall system overhead and the electrical characteristics of the hardware cables and serial device adapter type, the actual value of the maximum bit rate supported might be lower than this.
Fraction of Maximum Bit Rate Supported: The binary integer representing the fraction of the maximum bit rate supported for a COM port.

Returns

If the call is made with an invalid Parameter Packet value, a general failure error is reported and valid information is not returned in the Data Packet.

Remarks

If a general failure error is not returned, the physical device driver returns the bit rate values as defined. This function is extended from the current "Function 61h - Query Bit Rate".

@@ Line 1: / Line 1: @@
-This function returns the extended query bit rate in doublewords for a bit rate higher than 19200 bps.
+{{DISPLAYTITLE:ASYNC_EXTGETBAUDRATE}}
+This function returns the extended query bit rate in doublewords for a bit rate higher than 19200 bps.
-; Category:IOCTL_ASYNC (01h)
+;Category:IOCTL_ASYNC (01h)
-; Function: ASYNC_EXTGETBAUDRATE (63h)
+;Function: ASYNC_EXTGETBAUDRATE (63h)
 ==Parameter Packet Format==
 None. Packet pointer must be NULL.
 ==Data Packet Format==
+{|class="wikitable"
-<pre>
+!Field||Length||C Datatype
-┌──────────────────────────────────────────────────────┐
+|-
-│Field                          Length     C Datatype  │
+|Current Bit Rate||DWORD||ULONG
-├──────────────────────────────────────────────────────┤
+|-
-│Current Bit Rate               DWORD      ULONG       │
+|Fraction of Current Bit Rate||BYTE||UCHAR
-├──────────────────────────────────────────────────────┤
+|-
-│Fraction of Current Bit Rate   BYTE       UCHAR       │
+|Minimum Bit Rate Supported||DWORD||ULONG
-├──────────────────────────────────────────────────────┤
+|-
-│Minimum Bit Rate Supported     DWORD      ULONG       │
+|Fraction of Minimum Bit Rate Supported||BYTE||UCHAR
-├──────────────────────────────────────────────────────┤
+|-
-│Fraction of Minimum Bit Rate   BYTE       UCHAR       │
+|Maximum Bit Rate Supported||DWORD||ULONG
-│Supported                                             │
+|-
-├──────────────────────────────────────────────────────┤
+|Fraction of Maximum Bit Rate Supported||BYTE||UCHAR
-│Maximum Bit Rate Supported     DWORD      ULONG       │
+|}
-├──────────────────────────────────────────────────────┤
+;Current Bit Rate:The binary integer representing the actual bit rate in bits-per-seconds set for a COM port.
-│Fraction of Maximum Bit Rate   BYTE       UCHAR       │
+;Fraction of Current Bit Rate:The binary integer representing the fraction of the actual current bit rate set for a COM port.
-│Supported                                             │
+;Minimum Bit Rate Supported:The binary integer representing the minimum bit rate (in bits-per-second) port for a COM port.
-└──────────────────────────────────────────────────────┘
+;Maximum Bit Rate Supported:The binary integer representing the maximum bit rate (in bits-per-second) supported for a COM port. Depending on overall system overhead and the electrical characteristics of the hardware cables and serial device adapter type, the actual value of the maximum bit rate supported might be lower than this.
-</pre>
+;Fraction of Maximum Bit Rate Supported:The binary integer representing the fraction of the maximum bit rate supported for a COM port.
-;Current Bit Rate
-:The binary integer representing the actual bit rate in bits-per-seconds set for a COM port.
-;Fraction of Current Bit Rate
-:The binary integer representing the fraction of the actual current bit rate set for a COM port.
-;Minimum Bit Rate Supported
-:The binary integer representing the minimum bit rate (in bits-per-second) port for a COM port.
-;Maximum Bit Rate Supported
-:The binary integer representing the maximum bit rate (in bits-per-second) supported for a COM port. Depending on overall system overhead and the electrical characteristics of the hardware cables and serial device adapter type, the actual value of the maximum bit rate supported might be lower than this.
-;Fraction of Maximum Bit Rate Supported
-:The binary integer representing the fraction of the maximum bit rate supported for a COM port.
 ==Returns==
 If the call is made with an invalid Parameter Packet value, a general failure error is reported and valid information is not returned in the Data Packet.
 ==Remarks==
 If a general failure error is not returned, the physical device driver returns the bit rate values as defined. This function is extended from the current "Function 61h - Query Bit Rate".
-[[Category:IOCtl Commands]]
+[[Category:IOCtl Function]]
-{{DISPLAYTITLE:ASYNC_EXTGETBAUDRATE (63h)}}