Fungsi SerCxGetActivity (sercx.h)

Artikel
02/26/2024

Metode SerCxGetActivity mengambil status pekerjaan yang tertunda untuk driver pengontrol serial.

Sintaks

void SerCxGetActivity(
  [in]      WDFDEVICE       Device,
  [in, out] PSERCX_ACTIVITY Activity
);

Parameter

[in] Device

Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial.

[in, out] Activity

Penunjuk ke struktur SERCX_ACTIVITY yang dialokasikan penelepon. Pemanggil sebelumnya harus memanggil fungsi SERCX_ACTIVITY_INIT untuk menginisialisasi struktur ini sebelum penggunaan awalnya. Setelah itu, setiap panggilan SerCxGetActivity memperbarui konten struktur ini untuk melacak item kerja yang siap diproses oleh driver pengontrol.

Nilai kembali

Tidak ada

Keterangan

Driver pengontrol serial memanggil metode ini untuk menerima ringkasan pekerjaan pemrosesan yang perlu dilakukan atas nama ekstensi kerangka kerja serial (SerCx). Biasanya, SerCxGetActivity dipanggil oleh rutinitas DPC transmit/receive di driver pengontrol.

Parameter Aktivitas menunjuk ke struktur SERCX_ACTIVITY yang menjelaskan pekerjaan yang tertunda untuk driver pengontrol. Pekerjaan tertunda yang ditetapkan SerCx ke driver pengontrol 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.

Untuk menelusuri item kerja yang tertunda, DPC transmit/receive rutin memanggil SerCxGetActivity, memproses operasi pengiriman atau penerimaan lengkap, lalu memanggil SerCxGetActivity lagi untuk menentukan apakah operasi lain dari jenis yang berbeda memerlukan pekerjaan. Jika operasi lain memerlukan pekerjaan, pekerjaan ini mungkin dimulai selama panggilan balik yang sama tetapi harus berhenti jika nilai pengembalian dari panggilan ke SerCxProgressReceive atau SerCxProgressTransmit mengarahkan rutinitas DPC untuk menjadwalkan ulang dirinya sendiri untuk berjalan di lain waktu.

Kunci melindungi struktur SERCX_ACTIVITY yang diperbarui oleh panggilan SerCxGetActivity . Selama panggilan, kunci ini diperoleh oleh penanganan aktivitas di SerCx untuk memperbarui ringkasan pekerjaan yang saat ini tertunda untuk driver pengontrol.