Handel Objek SerCx2
Topik ini menjelaskan jenis handel objek yang secara khusus didefinisikan untuk versi 2 dari ekstensi kerangka kerja serial (SerCx2).
Antarmuka driver perangkat (DDI) SerCx2 menggunakan jenis handel ini untuk merujuk ke objek yang memiliki fitur dan kemampuan khusus untuk SerCx2.
Selain itu, SerCx2 DDI menggunakan dua jenis handel objek generik, WDFDEVICE dan WDFREQUEST, yang ditentukan oleh Kernel-Mode Driver Framework (KMDF).
Untuk informasi selengkapnya tentang jenis handel kerangka kerja, lihat Ringkasan Objek Kerangka Kerja.
Topik ini menjelaskan penanganan objek berikut:
- Gagang Objek SERCX2CUSTOMRECEIVE
- Handel Objek SERCX2CUSTOMRECEIVETRANSACTION
- Gagang Objek SERCX2CUSTOMTRANSMIT
- Handel Objek SERCX2CUSTOMTRANSMITTRANSACTION
- Handel Objek SERCX2PIORECEIVE
- Handel Objek SERCX2PIOTRANSMIT
- Handel Objek SERCX2SYSTEMDMARECEIVE
- Handel Objek SERCX2SYSTEMDMATRANSMIT
Header: 2.0\Sercx.h
Gagang Objek SERCX2CUSTOMRECEIVE
Handel objek SERCX2CUSTOMRECEIVE adalah referensi buram ke objek penerima kustom di versi 2 ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2CustomReceiveCreate membuat objek penerima kustom. SerCx2 menggunakan objek ini untuk mengelola transaksi I/O yang menggunakan mekanisme transfer data kustom untuk membaca data dari pengontrol serial. Obyek ini buram untuk pengandar pengontrol serial.
SerCx2CustomReceiveCreate memasok, sebagai parameter output, handel SERCX2CUSTOMRECEIVE ke objek penerima kustom yang baru dibuat.
SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam panggilan berikutnya ke metode SerCx2 dan fungsi panggilan balik peristiwa.
Setelah SerCx2CustomReceiveCreate membuat objek penerima kustom, objek ini ada selama masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial. Objek penerima kustom secara otomatis dihapus saat objek perangkat dihapus. Driver pengontrol serial tidak boleh mencoba menghapus objek penerima kustom dengan memanggil metode seperti WdfObjectDelete.
Driver pengontrol serial dapat, sebagai opsi, membuat objek penerima kustom, tetapi dapat membuat tidak lebih dari satu objek tersebut.
Driver hanya dapat membuat objek ini dalam kondisi berikut:
- Driver sebelumnya membuat objek penerima PIO.
- Driver belum membuat objek system-DMA-receive.
Untuk informasi selengkapnya tentang objek penerima PIO, lihat SERCX2PIORECEIVE Object Handle.
Untuk informasi selengkapnya tentang objek system-DMA-receive, lihat SERCX2SYSTEMDMARECEIVE Object Handle.
Handel Objek SERCX2CUSTOMRECEIVETRANSACTION
Handel objek SERCX2CUSTOMRECEIVETRANSACTION adalah referensi buram ke objek transaksi penerima kustom di versi 2 ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2CustomReceiveTransactionCreate membuat objek transaksi penerimaan kustom. SerCx2 menggunakan objek ini untuk mengelola transaksi I/O yang menggunakan mekanisme transfer data kustom untuk membaca data yang diterima oleh pengontrol serial.
Obyek ini buram untuk pengandar pengontrol serial.
SerCx2CustomReceiveTransactionBuat pasokan , sebagai parameter output, handel SERCX2CUSTOMRECEIVETRANSACTION ke objek transaksi penerima kustom yang baru dibuat.
SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam transaksi penerimaan kustom berikutnya.
Untuk informasi selengkapnya, lihat Transaksi Custom-Receive SerCx2.
Setelah SerCx2CustomReceiveTransactionCreate membuat objek custom-receive-transaction, objek ini ada selama masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial.
Objek transaksi penerima kustom secara otomatis dihapus saat objek perangkat dihapus.
Driver pengontrol serial tidak boleh mencoba menghapus objek transaksi penerima kustom dengan memanggil metode seperti WdfObjectDelete.
Driver pengontrol serial dapat, sebagai opsi, membuat objek transaksi penerimaan kustom, tetapi dapat membuat tidak lebih dari satu objek tersebut.
Driver hanya dapat membuat objek ini dalam kondisi berikut:</wdcml:p>
- Driver sebelumnya membuat objek penerima PIO.
- Driver sebelumnya membuat objek penerima kustom.
Untuk informasi selengkapnya tentang objek penerima PIO, lihat SERCX2PIORECEIVE Object Handle. Untuk informasi selengkapnya tentang objek penerima kustom, lihat SERCX2CUSTOMRECEIVE Object Handle.
Terlepas dari masa pakai yang sama dari objek penerima kustom dan transaksi penerimaan kustom, ini didefinisikan sebagai jenis objek terpisah (dan tidak digabungkan menjadi satu jenis) untuk mendukung kemungkinan perluasan antarmuka driver perangkat SerCx2 di masa mendatang.
Gagang Objek SERCX2CUSTOMTRANSMIT
Handel objek SERCX2CUSTOMTRANSMIT adalah referensi buram ke objek transmisi kustom di versi 2 dari ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2CustomTransmitCreate membuat object.h SerCx2 transmisi kustom menggunakan objek ini untuk mengelola transaksi I/O yang menulis data ke pengontrol serial. Obyek ini buram untuk pengandar pengontrol serial.
SerCx2CustomTransmitCreate menyediakan, sebagai parameter output, handel SERCX2CUSTOMTRANSMIT ke objek transmisi kustom yang baru dibuat. SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam panggilan berikutnya ke metode SerCx2 dan fungsi panggilan balik peristiwa.
Setelah SerCx2CustomTransmitCreate membuat objek transmisi kustom, objek ini ada selama masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial.
Objek transmisi kustom secara otomatis dihapus saat objek perangkat dihapus. Driver pengontrol serial tidak boleh mencoba menghapus objek transmisi kustom dengan memanggil metode seperti WdfObjectDelete.
Driver pengontrol serial dapat, sebagai opsi, membuat objek transmisi kustom, tetapi dapat membuat tidak lebih dari satu objek tersebut.
Driver hanya dapat membuat objek ini dalam kondisi berikut:
- Driver sebelumnya membuat objek transmisi PIO.
- Driver belum membuat objek transmisi DMA-sistem.
Untuk informasi selengkapnya tentang objek transmisi PIO, lihat HANDEL Objek SERCX2PIOTRANSMIT. Untuk informasi selengkapnya tentang objek transmisi DMA sistem, lihat Handel Objek SERCX2SYSTEMDMATRANSMIT.
Handel Objek SERCX2CUSTOMTRANSMITTRANSACTION
Handel objek SERCX2CUSTOMTRANSMITTRANSACTION adalah referensi buram ke objek transaksi transmisi kustom di versi 2 dari ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2CustomTransmitTransactionCreate membuat objek transaksi transmisi kustom. SerCx2 menggunakan objek ini untuk mengelola transaksi I/O yang menggunakan mekanisme transfer data kustom untuk menulis data ke pengontrol serial. Obyek ini buram untuk pengandar pengontrol serial.
SerCx2CustomTransmitTransactionCreate menyediakan, sebagai parameter output, handel SERCX2CUSTOMTRANSMITTRANSACTION ke objek transaksi pengiriman kustom yang baru dibuat. SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam transaksi pengiriman kustom berikutnya.
Untuk informasi selengkapnya, lihat Transaksi Custom-Transmit SerCx2.
Setelah SerCx2CustomTransmitTransactionCreate membuat objek transaksi transmisi kustom, objek ini ada untuk masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial. Objek transaksi transmisi kustom secara otomatis dihapus saat objek perangkat dihapus. Driver pengontrol serial tidak boleh mencoba menghapus objek transaksi transmisi kustom dengan memanggil metode seperti WdfObjectDelete.
Driver pengontrol serial dapat, sebagai opsi, membuat objek transmisi kustom, tetapi dapat membuat tidak lebih dari satu objek tersebut. Driver hanya dapat membuat objek ini dalam kondisi berikut:
- Driver sebelumnya membuat objek transmisi PIO.
- Driver belum membuat objek transmisi DMA-sistem.
Untuk informasi selengkapnya tentang objek transmisi PIO, lihat HANDEL Objek SERCX2PIOTRANSMIT. Untuk informasi selengkapnya tentang objek transmisi kustom, lihat SERCX2CUSTOMTRANSMIT Object Handle.
Meskipun masa pakai yang sama dari objek transaksi transmisi kustom dan transaksi transmisi kustom, ini didefinisikan sebagai jenis objek terpisah (dan tidak digabungkan menjadi satu jenis) untuk mendukung kemungkinan perluasan antarmuka driver perangkat SerCx2 di masa mendatang.
Handel Objek SERCX2PIORECEIVE
Handel objek SERCX2PIORECEIVE adalah referensi buram ke objek penerima PIO di versi 2 dari ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2PioReceiveCreate membuat objek penerima PIO. SerCx2 menggunakan objek untuk mengelola transaksi I/O (PIO) terprogram yang membaca data dari pengontrol serial. Obyek ini buram untuk pengandar pengontrol serial. sebagai parameter output, handel SERCX2PIORECEIVE ke objek penerima PIO yang baru dibuat. SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam transaksi penerimaan PIO berikutnya.
Untuk informasi selengkapnya, lihat Transaksi PIO-Receive SerCx2. Setelah SerCx2PioReceiveCreate membuat objek penerima PIO, objek ini ada selama masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial. Objek penerima PIO secara otomatis dihapus saat objek perangkat dihapus. Driver pengontrol serial tidak boleh mencoba menghapus objek penerima PIO dengan memanggil metode seperti WdfObjectDelete.
Driver pengontrol serial harus membuat satu dan hanya satu objek penerima PIO. Pengandar harus membuat objek ini sebelum membuat objek penerima-DMA-sistem atau objek penerima kustom. Untuk informasi selengkapnya tentang objek system-DMA-receive, lihat SERCX2SYSTEMDMARECEIVE Object Handle. Untuk informasi selengkapnya tentang objek penerima kustom, lihat SERCX2CUSTOMRECEIVE Object Handle.
Handel Objek SERCX2PIOTRANSMIT
Handel objek SERCX2PIOTRANSMIT adalah referensi buram ke objek transmisi PIO di versi 2 dari ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2PioTransmitCreate membuat objek transmisi PIO. SerCx2 menggunakan objek ini untuk mengelola transaksi I/O yang menggunakan I/O terprogram (PIO) untuk menulis data ke pengontrol serial. Obyek ini buram untuk pengandar pengontrol serial. SerCx2PioTransmitCreate menyediakan, sebagai parameter output, handel SERCX2PIOTRANSMIT ke objek transmisi PIO yang baru dibuat. SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam transaksi pengiriman PIO berikutnya. Untuk informasi selengkapnya, lihat Transaksi PIO-Transmit SerCx2. Setelah SerCx2PioTransmitCreate membuat objek transmisi PIO, objek ini ada selama masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial. Objek transmisi PIO secara otomatis dihapus saat objek perangkat dihapus. Driver pengontrol serial tidak boleh mencoba menghapus objek transmisi PIO dengan memanggil metode seperti WdfObjectDelete.
Driver pengontrol serial harus membuat satu dan hanya satu objek transmisi PIO. Pengandar harus membuat objek ini sebelum membuat objek transmisi DMA sistem atau objek transmisi kustom. Untuk informasi selengkapnya tentang objek transmisi DMA sistem, lihat Handel Objek SERCX2SYSTEMDMATRANSMIT. Untuk informasi selengkapnya tentang objek transmisi kustom, lihat SERCX2CUSTOMTRANSMIT Object Handle.
Handel Objek SERCX2SYSTEMDMARECEIVE
Handel objek SERCX2SYSTEMDMARECEIVE adalah referensi buram ke objek yang diterima DMA-sistem di versi 2 dari ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2SystemDmaReceiveCreate membuat objek system-DMA-receive. SerCx2 menggunakan objek ini untuk mengelola transaksi DMA sistem yang membaca data dari pengontrol serial. Obyek ini buram untuk pengandar pengontrol serial. SerCx2SystemDmaReceiveCreate memasok, sebagai parameter output, handel SERCX2SYSTEMDMARECEIVE ke objek penerimaan DMA sistem yang baru dibuat. SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam transaksi penerimaan DMA sistem berikutnya. Untuk informasi selengkapnya, lihat Transaksi Penerimaan SerCx2 System-DMA.
Setelah SerCx2SystemDmaReceiveCreate membuat objek system-DMA-receive, objek ini ada selama masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial. Objek system-DMA-receive secara otomatis dihapus ketika objek perangkat dihapus. Driver pengontrol serial dapat, sebagai opsi, membuat objek system-DMA-receive, tetapi dapat membuat tidak lebih dari satu objek tersebut. Driver hanya dapat membuat objek ini dalam kondisi berikut:
- Driver sebelumnya membuat objek penerima PIO.
- Driver belum membuat objek penerima kustom.
Untuk informasi selengkapnya tentang objek penerima PIO, lihat SERCX2PIORECEIVE Object Handle. Untuk informasi selengkapnya tentang objek penerima kustom, lihat SERCX2CUSTOMRECEIVE Object Handle.
Handel Objek SERCX2SYSTEMDMATRANSMIT
Handel objek SERCX2SYSTEMDMATRANSMIT adalah referensi buram ke objek transmisi DMA sistem di versi 2 dari ekstensi kerangka kerja serial (SerCx2).
Metode SerCx2SystemDmaTransmitCreate membuat objek transmisi DMA sistem. SerCx2 menggunakan objek ini untuk mengelola transaksi DMA sistem yang menulis data ke pengontrol serial. Obyek ini buram untuk pengandar pengontrol serial. SerCx2SystemDmaTransmitCreate memasok, sebagai parameter output, handel SERCX2SYSTEMDMATRANSMIT ke objek transmisi DMA sistem yang baru dibuat. SerCx2 dan driver pengontrol serial menggunakan handel ini untuk merujuk ke objek dalam transaksi transmisi DMA sistem berikutnya. Untuk informasi selengkapnya, lihat SerCx2 System-DMA-Transmit Transactions.
Setelah SerCx2SystemDmaTransmitCreate membuat objek transmisi DMA sistem, objek ini ada untuk masa pakai objek perangkat kerangka kerja yang mewakili perangkat pengontrol serial. Objek transmisi DMA sistem secara otomatis dihapus ketika objek perangkat dihapus. Driver pengontrol serial tidak boleh mencoba menghapus objek transmisi DMA sistem dengan memanggil metode seperti WdfObjectDelete.
Driver pengontrol serial dapat, sebagai opsi, membuat objek transmisi DMA sistem, tetapi dapat membuat tidak lebih dari satu objek tersebut. Driver hanya dapat membuat objek ini dalam kondisi berikut:</wdcml:p>
- Driver sebelumnya membuat objek transmisi PIO.
- Pengandar belum membuat objek transmisi kustom.
Untuk informasi selengkapnya tentang objek transmisi PIO, lihat HANDEL Objek SERCX2PIOTRANSMIT. Untuk informasi selengkapnya tentang objek transmisi kustom, lihat SERCX2CUSTOMTRANSMIT Object Handle.
Topik terkait
Transaksi Custom-Receive SerCx2
Transaksi Custom-Transmit SerCx2
Transaksi Penerimaan SerCx2 System-DMA
Transaksi Transmisi SerCx2 System-DMA
SerCx2CustomReceiveTransactionCreate
SerCx2CustomTransmitTransactionCreate
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk