SerCx2CustomTransmitTransactionCreate (sercx.h)
Metode SerCx2CustomTransmitTransactionCreate membuat objek transaksi transmisi kustom, yang digunakan ekstensi kerangka kerja serial versi 2 (SerCx2) untuk melakukan transaksi pengiriman kustom.
Sintaks
NTSTATUS SerCx2CustomTransmitTransactionCreate(
[in] SERCX2CUSTOMTRANSMIT CustomTransmit,
[in] PSERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG CustomTransmitTransactionConfig,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] SERCX2CUSTOMTRANSMITTRANSACTION *CustomTransmitTransaction
);
Parameter
[in] CustomTransmit
Handel SERCX2CUSTOMTRANSMIT ke objek pengiriman kustom. Driver pengontrol serial sebelumnya disebut metode SerCx2CustomTransmitCreate untuk membuat objek ini.
[in] CustomTransmitTransactionConfig
Penunjuk ke struktur SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG . Sebelum memanggil metode ini, pemanggil harus memanggil fungsi SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG_INIT untuk menginisialisasi struktur. Struktur ini berisi pointer ke serangkaian rutinitas panggilan balik peristiwa yang diimplementasikan oleh driver pengontrol serial. SerCx2 memanggil fungsi-fungsi ini untuk melakukan transaksi I/O yang menggunakan mekanisme transfer data kustom untuk menulis data ke pengontrol serial yang akan ditransmisikan.
[in] Attributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang menjelaskan atribut untuk ditetapkan ke objek transaksi transmisi kustom baru. Sebelum memanggil metode ini, pemanggil harus memanggil fungsi WDF_OBJECT_ATTRIBUTES_INIT untuk menginisialisasi struktur. Parameter ini bersifat opsional dan dapat ditentukan sebagai WDF_NO_OBJECT_ATTRIBUTES jika driver pengontrol serial tidak perlu menetapkan atribut ke objek. Untuk informasi selengkapnya, lihat Keterangan.
[out] CustomTransmitTransaction
Penunjuk ke lokasi tempat metode ini menulis handel SERCX2CUSTOMTRANSMITTRANSACTION ke objek transaksi transmisi kustom yang baru dibuat. SerCx2 dan driver pengontrol serial menggunakan handel ini dalam panggilan berikutnya untuk merujuk ke objek ini.
Nilai kembali
Metode ini mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Objek transaksi transmisi kustom sudah ada dari panggilan SerCx2CustomTransmitTransactionCreate sebelumnya. |
|
Nilai Ukuran CustomTransmitTransactionConfig-> tidak sama dengan sizeof(SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG). |
|
Nilai parameter tidak valid. Pemanggil harus menyediakan penunjuk fungsi EvtSerCx2CustomTransmitTransactionStart yang valid. |
|
Sumber daya yang tersedia tidak cukup untuk membuat objek transaksi transmisi kustom. |
Keterangan
Driver pengontrol serial Anda dapat memanggil metode ini untuk membuat objek transaksi transmisi kustom. SerCx2 menggunakan objek ini untuk mengelola transaksi pengiriman kustom, yaitu transaksi I/O yang menggunakan mekanisme transfer data kustom untuk menulis data ke pengontrol serial yang akan ditransmisikan.
Sebagai opsi, driver pengontrol serial dapat menggunakan parameter Atribut untuk membuat konteks untuk objek transmisi kustom, dan untuk memasok pointer ke fungsi EvtCleanupCallback dan EvtDestroyCallback yang dipanggil untuk menyiapkan objek untuk penghapusan. Untuk informasi selengkapnya, lihat WDF_OBJECT_ATTRIBUTES.
Jika parameter Atribut menunjuk ke struktur WDF_OBJECT_ATTRIBUTES , pemanggil tidak boleh menimpa nilai yang ditulis fungsi inisialisasi WDF_OBJECT_ATTRIBUTES_INIT ke anggota ParentObject, ExecutionLevel, dan SynchronizationScope dari struktur ini.
Jika kombinasi yang ditentukan dari fungsi panggilan balik yang diimplementasikan tidak valid, SerCx2CustomTransmitTransactionCreate gagal dan mengembalikan STATUS_INVALID_PARAMETER.
Untuk informasi selengkapnya tentang membuat objek transaksi pengiriman kustom, lihat SERCX2CUSTOMTRANSMITTRANSACTION. Untuk informasi selengkapnya tentang transaksi pengiriman kustom, lihat Transaksi Custom-Transmit SerCx2.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8.1. |
Target Platform | Universal |
Header | sercx.h |
IRQL | PASSIVE_LEVEL |
Lihat juga
EvtSerCx2CustomTransmitTransactionStart
SERCX2CUSTOMTRANSMITTRANSACTION
SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG
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