Fungsi SerCxDeviceInitConfig (sercx.h)
Metode SerCxDeviceInitConfig dipanggil oleh driver pengontrol serial untuk melampirkan ekstensi kerangka kerja serial (SerCx) ke alur I/O untuk objek perangkat kerangka kerja (FDO atau PDO) yang dibuatnya.
Sintaks
NTSTATUS SerCxDeviceInitConfig(
[in, out] PWDFDEVICE_INIT DeviceInit
);
Parameter
[in, out] DeviceInit
Penunjuk ke struktur WDFDEVICE_INIT yang akan dikonfigurasi.
Nilai kembali
SerCxDeviceInitConfig mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Tidak dapat mengalokasikan sumber daya sistem (biasanya memori). |
Keterangan
Metode ini mengaitkan informasi konfigurasi SerCx dengan struktur WDFDEVICE_INIT untuk objek perangkat kerangka kerja (PDO atau FDO) yang akan dibuat. Panggil SerCxDeviceInitConfig sebelum Anda memanggil metode WdfDeviceCreate untuk membuat objek perangkat.
Fungsi panggilan balik EvtDriverDeviceAdd driver pengontrol menerima penunjuk ke struktur WDFDEVICE_INIT yang diinisialisasi sebagai parameter input.
SerCx menetapkan deskriptor keamanan default yang dapat diambil alih oleh driver pengontrol serial, jika perlu. Misalnya, deskriptor keamanan default ini memungkinkan driver mode pengguna untuk mengirim permintaan I/O ke perangkat periferal yang terhubung ke port pada pengontrol serial. Untuk mengubah pengaturan ini di deskriptor keamanan, driver pengontrol serial dapat memanggil metode WdfDeviceInitAssignSDDLString . Panggilan ini harus terjadi setelah panggilan SerCxDeviceInitConfig , tetapi sebelum panggilan ke metode WdfDeviceCreate .
Contoh
Dalam contoh kode berikut, fungsi panggilan balik EvtDriverDeviceAdd driver pengontrol meneruskan struktur WDFDEVICE_INIT yang diinisialisasi ke metode SerCxDeviceInitConfig . Panggilan ke SerCxDeviceInitConfig harus terjadi sebelum panggilan WdfDeviceCreate yang membuat FDO untuk perangkat pengontrol serial (UART).
//
// FxDeviceInit is a pointer to an initialized WDFDEVICE_INIT structure.
// Drivers receive a pointer to this structure as an input parameter to an
// EvtDriverDeviceAdd callback function, or as a return value from the
// WdfControlDeviceInitAllocate method.
//
status = SerCxDeviceInitConfig(FxDeviceInit);
if (!NT_SUCCESS(status))
{
return status;
}
//
// Set WDF and SerCx device-level configuration options.
//
...
//
// Call the WdfDeviceCreate method.
//
...
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