Fungsi SerCx2InitializeDeviceInit (sercx.h)
Metode SerCx2InitializeDeviceInit memungkinkan ekstensi kerangka kerja serial (SerCx2) versi 2 untuk mendaftarkan properti khusus ekstensi dengan kerangka kerja driver selama pembuatan objek perangkat kerangka kerja untuk pengontrol serial.
Sintaks
NTSTATUS SerCx2InitializeDeviceInit(
[in, out] PWDFDEVICE_INIT DeviceInit
);
Parameter
[in, out] DeviceInit
Penunjuk ke struktur WDFDEVICE_INIT , yang merupakan struktur buram yang menyimpan informasi yang digunakan Kerangka Kerja Driver Mode Kernel (KMDF) untuk membuat objek perangkat kerangka kerja. Driver pengontrol serial menerima penunjuk ke struktur ini sebagai parameter input ke fungsi panggilan balik EvtDriverDeviceAdd driver.
Nilai kembali
SerCx2InitializeDeviceInit mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode ini dipanggil pada IRQL yang salah, atau parameter DeviceInit adalah NULL. |
|
Sumber daya yang tidak mencukup tersedia untuk melakukan operasi yang diminta. |
Keterangan
Driver pengontrol serial harus memanggil metode ini dari fungsi panggilan balik EvtDriverDeviceAdd sebelum membuat objek WDFDEVICE untuk pengontrol serial.
SerCx2InitializeDeviceInit melampirkan informasi khusus ekstensi ke struktur WDFDEVICE_INIT driver. Informasi ini memungkinkan SerCx2 untuk melakukan tindakan tertentu atas nama driver pengontrol serial. Misalnya, SerCx2 menerima permintaan I/O yang dikirim klien ke pengontrol serial.
Driver pengontrol serial harus memanggil SerCx2InitializeDeviceInit sebelum membuat objek perangkat kerangka kerja untuk mewakili pengontrol serial, dan sebelum memanggil metode SerCx2InitializeDevice untuk menyelesaikan inisialisasi objek perangkat. Driver memanggil metode seperti WdfDeviceCreate untuk membuat objek perangkat.
SerCx2InitializeDeviceInit menetapkan deskriptor keamanan default yang memungkinkan driver mode kernel dan driver mode pengguna untuk mengirim permintaan I/O ke SerCx2. Deskriptor memungkinkan aplikasi untuk mengirim permintaan ini hanya jika mereka berjalan dengan hak istimewa administrator. Untuk menentukan deskriptor ini, SerCx2 menggunakan string SDDL berikut:
"D:P(A;;GA;;;SY)(A;;GA;;;BA)(A;;GA;;;UD)"
Jika perlu, driver pengontrol serial dapat mengganti pengaturan default dengan memanggil metode WdfDeviceInitAssignSDDLString dengan deskriptor keamanan yang diinginkan. Driver harus memanggil WdfDeviceInitAssignSDDLString setelah memanggil SerCx2InitializeDeviceInit tetapi sebelum memanggil WdfDeviceCreate. Untuk informasi selengkapnya tentang string SDDL, lihat SDDL untuk Objek Perangkat.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8.1. |
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