Win32_SerialPortConfiguration clase
La clase WMI de Win32_SerialPortConfiguration representa la configuración de la transmisión de datos en un puerto serie basado en Windows. Esto incluye configuraciones para establecer una conexión y una comprobación de errores.
La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.
Sintaxis
[Dynamic, Provider("CIMWin32"), UUID("{8502C4EB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SerialPortConfiguration : CIM_Setting
{
string Caption;
string Description;
string SettingID;
boolean AbortReadWriteOnError;
uint32 BaudRate;
boolean BinaryModeEnabled;
uint32 BitsPerByte;
boolean ContinueXMitOnXOff;
boolean CTSOutflowControl;
boolean DiscardNULLBytes;
boolean DSROutflowControl;
boolean DSRSensitivity;
string DTRFlowControlType;
uint32 EOFCharacter;
uint32 ErrorReplaceCharacter;
boolean ErrorReplacementEnabled;
uint32 EventCharacter;
boolean IsBusy;
string Name;
string Parity;
boolean ParityCheckEnabled;
string RTSFlowControlType;
string StopBits;
uint32 XOffCharacter;
uint32 XOffXMitThreshold;
uint32 XOnCharacter;
uint32 XOnXMitThreshold;
uint32 XOnXOffInFlowControl;
uint32 XOnXOffOutFlowControl;
};
Miembros
La clase Win32_SerialPortConfiguration tiene estos tipos de miembros:
Propiedades
La clase Win32_SerialPortConfiguration tiene estas propiedades.
-
AbortReadWriteOnError
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fAbortOnError")
Si es TRUE, las operaciones de lectura y escritura finalizan si se produce un error. Si es TRUE, el controlador finaliza todas las operaciones de lectura y escritura con un estado de error si se produce un error. El controlador no aceptará más operaciones de comunicaciones hasta que la aplicación confirme el error.
-
-
BaudRate
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| BaudRate")
Velocidad de baudios (bits por segundo) a la que opera el dispositivo de comunicaciones.
Ejemplo: 9600
-
-
BinaryModeEnabled
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fBinary")
Si es TRUE, las transferencias de datos en modo binario están habilitadas para el puerto serie. Los sistemas informáticos que ejecutan Windows solo permiten transferencias binarias a través de puertos serie, por lo que este valor siempre es TRUE.
-
-
BitsPerByte
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| ByteSize")
Número de bits transmitidos y recibidos para cada byte de datos para el puerto serie de Windows. El número puede variar con bits de control y corrección de errores, como bits de paridad.
Ejemplo: 8
-
-
Caption
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64)
Descripción textual breve del objeto actual.
Esta propiedad se hereda de CIM_Setting.
-
-
ContinueXMitOnXOff
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fTXContinueOnXoff")
Si es TRUE, las transmisiones de datos continúan cuando el búfer de entrada ha llegado a XOffXMitThreshold bytes de estar lleno y el controlador ha transmitido el valor XOffChararcter para dejar de recibir bytes. Si es FALSE, la transmisión no continúa hasta que el búfer de entrada se encuentra dentro de los bytes XOnXMitThreshold de estar vacíos y el controlador ha transmitido el valor XOnCharacter para reanudar la recepción.
-
-
CTSOutflowControl
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fOutxCtsFlow")
Si es TRUE, se comprueba la señal clara para enviar (CTS) antes de transmitir datos. CTS indica que ambos dispositivos de la conexión serie están listos para transferir datos. La transmisión de datos se suspende hasta que se da la señal CTS.
-
-
Descripción
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Descripción textual del objeto actual.
Esta propiedad se hereda de CIM_Setting.
-
-
DiscardNULLBytes
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fNull")
Si es TRUE, los bytes NULL (caracteres) se descartan cuando se reciben.
-
-
DSROutflowControl
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fOutxDsrFlow")
Si es TRUE, el control de flujo de salida de datos está habilitado cuando hay una condición lista para el conjunto de datos (DSR). DSR indica que los dispositivos han establecido la conexión en la conexión serie. La transmisión de datos de DSR se suspende hasta que se da la señal DSR.
-
-
DSRSensitivity
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fDsrSensitivity")
Si es TRUE, el controlador de comunicaciones es sensible al estado de la señal DSR. El controlador omite los bytes recibidos, a menos que la línea de entrada del módem DSR sea alta.
-
-
DTRFlowControlType
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fDtrControl")
Uso del control de flujo listo para el terminal de datos (DTR) después de establecer una conexión.
-
-
Habilitar ("Habilitar")
-
Deshabilitar ("Deshabilitar")
-
Protocolo de enlace ("Protocolo de enlace")
EOFCharacter
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| EofChar")
Valor del carácter utilizado para indicar el final de los datos.
Ejemplo: ^Z
ErrorReplaceCharacter
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| ErrorChar")
Valor del carácter usado para reemplazar bytes recibidos por un error de paridad.
Ejemplo: ^C
ErrorReplacementEnabled
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fErrorChar")
Si es TRUE, los bytes recibidos con errores de paridad se reemplazan por el valor ErrorReplaceCharacter . Los caracteres con errores de paridad solo se reemplazan si esta propiedad es TRUE y la paridad está habilitada.
EventCharacter
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| EvtChar")
Valor del carácter de control que se usa para indicar un evento, como el final del archivo.
Ejemplo: ^e
IsBusy
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Funciones de archivo| CreateFile")
Si es TRUE, el puerto serie está ocupado.
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: key, MaxLen (256), MappingStrings ("Win32Registry| Hardware\\DeviceMap\\SerialComm")
Nombre del puerto serie de Windows.
Ejemplo: "COM1"
Paridad
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| Paridad")
Método de comprobación de paridad que se va a usar. La paridad se usa como técnica de comprobación de errores en la que se incluye un bit de paridad adicional con cada unidad de datos. A continuación, el receptor puede comprobar la validez de los datos contando los bits establecidos.
None ("None")
No se usa la comprobación de paridad.
Impar ("Impar ")
Establece el bit de paridad de forma que el recuento de bits establecidos sea un número impar.
Incluso ("Incluso")
Establece el bit de paridad de forma que el recuento de bits establecidos sea un número par.
Mark ("Mark")
Establece el conjunto de bits de paridad en 1.
Espacio ("Espacio")
Deja el bit de paridad establecido en 0 (cero).
ParityCheckEnabled
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fParity")
Si es TRUE, la comprobación de paridad está habilitada.
RTSFlowControlType
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Solicitud para enviar el control de flujo (RTS). RTS se usa para indicar que los datos están disponibles para la transmisión.
Habilitar ("Habilitar")
RTS se deja en para la sesión de transferencia de datos.
Deshabilitar ("Deshabilitar")
RTS se omite después de recibir la primera señal RTS.
Protocolo de enlace ("Protocolo de enlace")
RTS se desactiva si el búfer de transmisión está lleno de más de tres cuartos y RTS se activa cuando el búfer es inferior a la mitad completa.
Alternancia ("Alternar ")
RTS está activado si hay algún búfer de datos para la transmisión.
SettingID
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (256)
Identificador por el que se conoce el objeto actual.
Esta propiedad se hereda de CIM_Setting.
StopBits
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| StopBits")
Número de bits de detención que se van a usar. Detenga los bits para separar cada unidad de datos en una conexión serie asincrónica. También se envían continuamente cuando no hay datos disponibles para la transmisión.
1 ("1")
1,5 ("1,5")
2 ("2")
XOffCharacter
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| XoffChar")
Valor del carácter XOFF para la transmisión y la recepción. XOFF es un control de software para detener la transmisión de datos (mientras que RTS y CTS son controles de hardware). XON reanuda la transmisión.
XOffXMitThreshold
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| XoffLim")
Número máximo de bytes permitidos en el búfer de entrada antes de enviar el carácter XOFF.
XOnCharacter
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| XonChar")
Valor del carácter XON para la transmisión y la recepción. XON es un control de software para reanudar la transmisión de datos (mientras que RTS y CTS son controles de hardware). XOFF detiene la transmisión.
XOnXMitThreshold
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB| XonLim")
Número mínimo de bytes permitidos en el búfer de entrada antes de enviar el carácter XON. Esta propiedad funciona junto con XOffXMitThreshold para regular la velocidad a la que se transfieren los datos.
XOnXOffInFlowControl
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fInX")
Si es TRUE, se usa el control de flujo XON/XOFF durante la recepción. Si es TRUE, el valor XOffCharacter se envía cuando el búfer de entrada entra en bytes XOffXMitThreshold de estar lleno y el valor XOnCharacter se envía cuando el búfer de entrada entra en bytes XOnXMitThreshold de estar vacío.
0
FALSE
1
TRUE
XOnXOffOutFlowControl
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("Win32API| Estructuras de comunicación | DCB|fOutX")
XOnXOffOutFlowControl especifica si se usa el control de flujo XON o XOFF durante la transmisión. Si es TRUE, la transmisión se detiene cuando se recibe el valor XOffCharacter y se inicia de nuevo cuando se recibe el valor XOnCharacter .
Comentarios
La clase Win32_SerialPortConfiguration se deriva de CIM_Setting.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de