kelas Win32_SerialPortConfiguration

Artikel
06/12/2023

Kelas WMI Win32_SerialPortConfiguration mewakili pengaturan untuk transmisi data pada port serial berbasis Windows. Ini termasuk konfigurasi untuk membuat koneksi dan pemeriksaan kesalahan.

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.

Sintaks

[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;
};

Anggota

Kelas Win32_SerialPortConfiguration memiliki jenis anggota ini:

Properti

Properti

Kelas Win32_SerialPortConfiguration memiliki properti ini.

AbortReadWriteOnError

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fAbortOnError")

Jika TRUE, operasi baca dan tulis dihentikan jika terjadi kesalahan. Jika TRUE, driver mengakhiri semua operasi baca dan tulis dengan status kesalahan jika terjadi kesalahan. Driver tidak akan menerima operasi komunikasi lebih lanjut sampai aplikasi mengakui kesalahan.

BaudRate

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| BaudRate")

Laju Baud (bit per detik) tempat perangkat komunikasi beroperasi.

Contoh: 9600

BinaryModeEnabled

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fBinary")

Jika TRUE, transfer data mode biner diaktifkan untuk port serial. Sistem komputer yang menjalankan Windows hanya mengizinkan transfer biner melalui port seri, sehingga nilai ini selalu TRUE.

BitsPerByte

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| Ukuran Byte")

Jumlah bit yang dikirimkan dan diterima untuk setiap byte data untuk port seriAl Windows. Angka dapat bervariasi dengan bit koreksi kontrol dan kesalahan, seperti bit paritas.

Contoh: 8

Keterangan

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (64)

Deskripsi tekstual singkat dari objek saat ini.

Properti ini diwarisi dari CIM_Setting.

ContinueXMitOnXOff

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fTXContinueOnXoff")

Jika TRUE, transmisi data berlanjut ketika buffer input telah berada dalam byte XOffXMitThreshold penuh dan driver telah mengirimkan nilai XOffChararcter untuk berhenti menerima byte. Jika FALSE, transmisi tidak berlanjut sampai buffer input berada dalam byte XOnXMitThreshold kosong dan driver telah mengirimkan nilai XOnCharacter untuk melanjutkan penerimaan.

CTSOutflowControl

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fOutxCtsFlow")

Jika TRUE, sinyal clear to send (CTS) diperiksa sebelum mengirimkan data. CTS menandakan bahwa kedua perangkat pada koneksi serial siap untuk mentransfer data. Transmisi data ditangguhkan sampai sinyal CTS diberikan.

Deskripsi

Jenis data: string
Jenis akses: Baca-saja

Deskripsi tekstual objek saat ini.

Properti ini diwarisi dari CIM_Setting.

BuangNULLBytes

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fNull")

Jika TRUE, byte NULL (karakter) akan dibuang saat diterima.

DSROutflowControl

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fOutxDsrFlow")

Jika TRUE, kontrol aliran keluar data diaktifkan ketika ada kondisi siap himpunan data (DSR). DSR menandakan bahwa koneksi telah dibuat oleh perangkat pada koneksi serial. Transmisi data DSR ditangguhkan hingga sinyal DSR diberikan.

DSRSensitivitas

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fDsrSensitivity")

Jika TRUE, driver komunikasi sensitif terhadap status sinyal DSR. Driver mengabaikan byte apa pun yang diterima, kecuali baris input modem DSR tinggi.

DTRFlowControlType

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fDtrControl")

Penggunaan kontrol aliran siap terminal data (DTR) setelah koneksi dibuat.

Aktifkan ("Aktifkan")

Nonaktifkan ("Nonaktifkan")

Jabat tangan ("Jabat Tangan")

EOFCharacter

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| EofChar")

Nilai karakter yang digunakan untuk memberi sinyal akhir data.

Contoh: ^Z

ErrorReplaceCharacter

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| ErrorChar")

Nilai karakter yang digunakan untuk mengganti byte yang diterima dengan kesalahan paritas.

Contoh: ^C

ErrorReplacementEnabled

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fErrorChar")

Jika TRUE, byte yang diterima dengan kesalahan paritas diganti dengan nilai ErrorReplaceCharacter . Karakter dengan kesalahan paritas hanya diganti jika properti ini TRUE dan paritas diaktifkan.

EventCharacter

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| EvtChar")

Nilai karakter kontrol yang digunakan untuk memberi sinyal peristiwa, seperti akhir file.

Contoh: ^e

IsBusy

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Fungsi File| CreateFile")

Jika TRUE, port serial sibuk.

Nama

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: key, MaxLen (256), MappingStrings ("Win32Registry| Hardware\\DeviceMap\\SerialComm")

Nama port seri Windows.

Contoh: "COM1"

Paritas

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| Paritas")

Metode pemeriksaan paritas yang akan digunakan. Paritas digunakan sebagai teknik pemeriksaan kesalahan di mana bit paritas tambahan disertakan dengan setiap unit data. Penerima kemudian dapat memverifikasi validitas data dengan menghitung bit yang ditetapkan.

Tidak Ada ("Tidak Ada")

Pemeriksaan paritas tidak digunakan.

Ganjil ("Ganjil")

Mengatur bit paritas sehingga jumlah bit yang ditetapkan adalah angka ganjil.

Bahkan ("Genap")

Mengatur bit paritas sehingga jumlah bit yang ditetapkan adalah angka genap.

Tandai ("Tandai")

Membiarkan bit paritas diatur ke 1.

Spasi ("Spasi")

Membiarkan bit paritas diatur ke 0 (nol).

ParityCheckEnabled

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fParity")

Jika TRUE, pemeriksaan paritas diaktifkan.

RTSFlowControlType

Jenis data: string
Jenis akses: Baca-saja

Permintaan untuk mengirim (RTS) kontrol alur. RTS digunakan untuk memberi sinyal bahwa data tersedia untuk transmisi.

Aktifkan ("Aktifkan")

RTS dibiarkan aktif untuk sesi transfer data.

Nonaktifkan ("Nonaktifkan")

RTS diabaikan setelah sinyal RTS pertama diterima.

Jabat Tangan ("Jabat Tangan")

RTS dimatikan jika buffer transmisi lebih dari tiga perempat penuh, dan RTS dinyalakan ketika buffer kurang dari satu setengah penuh.

Alihkan ("Alihkan")

RTS diaktifkan jika ada data yang di-buffer untuk transmisi.

SettingID

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (256)

Pengidentifikasi tempat objek saat ini diketahui.

Properti ini diwarisi dari CIM_Setting.

StopBits

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| StopBits")

Jumlah bit berhenti yang akan digunakan. Bit berhenti memisahkan setiap unit data pada koneksi serial asinkron. Mereka juga dikirim terus menerus ketika tidak ada data yang tersedia untuk transmisi.

1 ("1")

1.5 ("1.5")

2 ("2")

XOffCharacter

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| XoffChar")

Nilai karakter XOFF untuk transmisi dan penerimaan. XOFF adalah kontrol perangkat lunak untuk menghentikan transmisi data (sedangkan RTS dan CTS adalah kontrol perangkat keras). XON melanjutkan transmisi.

XOffXMitThreshold

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| XoffLim")

Jumlah maksimum byte yang diizinkan dalam buffer input sebelum karakter XOFF dikirim.

XOnCharacter

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| XonChar")

Nilai karakter XON untuk transmisi dan penerimaan. XON adalah kontrol perangkat lunak untuk melanjutkan transmisi data (sedangkan RTS dan CTS adalah kontrol perangkat keras). XOFF menghentikan transmisi.

XOnXMitThreshold

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB| XonLim")

Jumlah minimum byte yang diizinkan dalam buffer input sebelum karakter XON dikirim. Properti ini bekerja bersama dengan XOffXMitThreshold untuk mengatur tarif di mana data ditransfer.

XOnXOffInFlowControl

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fInX")

Jika TRUE, kontrol alur XON/XOFF digunakan selama penerimaan. Jika TRUE, nilai XOffCharacter dikirim ketika buffer input berada dalam byte XOffXMitThreshold penuh, dan nilai XOnCharacter dikirim ketika buffer input berada dalam byte XOnXMitThreshold yang kosong.

FALSE

TRUE

XOnXOffOutFlowControl

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Komunikasi| DCB|fOutX")

XOnXOffOutFlowControl menentukan apakah kontrol aliran XON atau XOFF digunakan selama transmisi. Jika TRUE, transmisi berhenti ketika nilai XOffCharacter diterima dan dimulai lagi ketika nilai XOnCharacter diterima.

Keterangan

Kelas Win32_SerialPortConfiguration berasal dari CIM_Setting.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

CIM_Setting
Kelas Perangkat Keras Sistem Komputer

kelas Win32_SerialPortConfiguration

Sintaks

Anggota

Properti

Keterangan

Persyaratan

Lihat juga

Saran dan Komentar

Saran dan Komentar

Sumber Daya Tambahan: