struktur SERCX_ACTIVITY (sercx.h)

Artikel
08/07/2023

Struktur SERCX_ACTIVITY berisi ringkasan item kerja yang siap untuk diproses oleh driver pengontrol serial.

Sintaks

typedef struct _SERCX_ACTIVITY {
  ULONG   Size;
  BOOLEAN Transmitting;
  BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;

Anggota

Size

Ukuran, dalam byte, dari struktur ini. Metode SerCxGetActivity menggunakan anggota ini untuk menentukan versi struktur mana yang digunakan pemanggil. Ukuran struktur ini mungkin berubah dalam versi file header Sercx.h yang akan datang.

Transmitting

Apakah operasi transmisi (tulis) sedang berlangsung. Anggota ini TRUE jika operasi transmisi sedang berlangsung. Jika tidak, itu FALSE.

Receiving

Apakah operasi terima (baca) sedang berlangsung. Anggota ini TRUE jika operasi penerima sedang berlangsung. Jika tidak, itu FALSE.

Keterangan

Struktur ini harus diinisialisasi oleh fungsi SERCX_ACTIVITY_INIT sebelum penggunaan awalnya. Setelah itu, panggilan ke metode SerCxGetActivity memperbarui konten struktur ini untuk menunjukkan pekerjaan yang saat ini tertunda.

Struktur SERCX_ACTIVITY meringkas pekerjaan yang tertunda yang ditetapkan ekstensi kerangka kerja serial (SerCx) ke driver pengontrol serial. Pekerjaan ini didorong oleh permintaan I/O dari klien, tetapi permintaan I/O tidak selalu menghasilkan item kerja. Misalnya, jika SerCx memiliki jumlah data yang diterima yang cukup dalam buffer memorinya untuk menyelesaikan permintaan baca yang tertunda, permintaan ini tidak menyebabkan anggota Penerima struktur SERCX_ACTIVITY diatur ke TRUE.

Biasanya, SerCxGetActivity dipanggil dari perulangan utama fungsi DPC transmisi/terima di driver pengontrol serial. Fungsi ini memanggil SerCxGetActivity, memproses operasi pengiriman atau penerimaan lengkap, lalu memanggil SerCxGetActivity lagi untuk menentukan apakah operasi jenis lain memerlukan pekerjaan. Jika ada lebih banyak pekerjaan yang tersedia, fungsi DPC mungkin melakukan pekerjaan ini sebelum kembali.