Fungsi SerCxDeviceInitConfig (sercx.h)

Artikel
02/29/2024

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
STATUS_INSUFFICIENT_RESOURCES	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.
//

...