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
STATUS_INVALID_DEVICE_REQUEST
Metode ini dipanggil pada IRQL yang salah; atau handel WDFDEVICE tidak valid; atau FxDevice atau Config adalah NULL.
STATUS_INSUFFICIENT_RESOURCES
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

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT