Win32_SerialPortConfiguration clase

Artículo
06/12/2023

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

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.

FALSE

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	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_Setting
Clases de hardware del sistema de equipos

Compartir a través de

Win32_SerialPortConfiguration clase

Sintaxis

Miembros

Propiedades

Comentarios

Requisitos

Consulte también

Comentarios

Recursos adicionales