Fungsi SerCx2InitializeDeviceInit (sercx.h)

Artikel
10/30/2024

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.

Sintaksis

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 driver EvtDriverDeviceAdd.

Mengembalikan nilai

SerCx2InitializeDeviceInit mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.

Mengembalikan kode	Deskripsi
STATUS_INVALID_DEVICE_REQUEST	Metode ini dipanggil pada IRQL yang salah, atau parameter DeviceInit NULL.
STATUS_INSUFFICIENT_RESOURCES	Sumber daya yang tidak mencukup tersedia untuk melakukan operasi yang diminta.

Komentar

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:

Jika perlu, driver pengontrol serial dapat mengambil alih 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.