Fungsi SerCxInitialize (sercx.h)
Metode SerCxInitialize menyelesaikan inisialisasi ekstensi kerangka kerja serial (SerCx) setelah driver ini membuat objek perangkat terkait.
Sintaks
NTSTATUS SerCxInitialize(
[in] WDFDEVICE FxDevice,
[in] PSERCX_CONFIG Config
);
Parameter
[in] FxDevice
Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial.
[in] Config
Penunjuk ke struktur SERCX_CONFIG yang dialokasikan pemanggil yang berisi informasi konfigurasi untuk SerCx. Penelepon sebelumnya memanggil fungsi SERCX_CONFIG_INIT untuk menginisialisasi struktur ini.
Nilai kembali
SerCxInitialize mengembalikan STATUS_SUCCESS jika berhasil. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode ini dipanggil pada IRQL yang salah; atau handel WDFDEVICE tidak valid; atau FxDevice atau Config adalah NULL. |
|
Tidak dapat mengalokasikan sumber daya sistem (biasanya memori). |
Keterangan
Driver pengontrol serial memanggil metode ini setelah membuat objek perangkat terkait.
SerCxInitialize mendaftarkan fungsi panggilan balik I/O driver pengontrol dengan SerCx. Selain itu, metode ini mendefinisikan mode transfer untuk antrean I/O. Selama panggilan, metode ini membuat semua struktur internal yang diperlukan oleh SerCx (termasuk antrean I/O untuk pengontrol serial). Setelah metode ini kembali, SerCx siap untuk memproses I/O. Namun, driver pengontrol mungkin mengonfigurasi pengaturan perangkat keras pengontrol sebelum kembali dari panggilan balik EvtDriverDeviceAdd atau sebelum menambahkan PDO ke daftar anak.
Jika parameter tidak valid (seperti yang dijelaskan dalam SERCX_CONFIG), Pemverifikasi Driver akan menimbulkan kesalahan.
Rutinitas ini harus dipanggil sebelum menerapkan perangkat (kembali dari EvtDriverDeviceAdd atau menambahkan PDO ke daftar anak).
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
Target Platform | Universal |
Header | sercx.h |
IRQL | PASSIVE_LEVEL |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk