PPARALLEL_DESELECT_ROUTINE fungsi panggilan balik (parallel.h)
Rutinitas panggilan balik jenis PPARALLEL_DESELECT_ROUTINE membatalkan pilihan perangkat rantai daisy IEEE 1284.3 atau perangkat end-of-chain IEEE 1284 yang dilampirkan ke port paralel. Driver fungsi yang disediakan sistem untuk port paralel memasok rutinitas ini.
Sintaks
PPARALLEL_DESELECT_ROUTINE PparallelDeselectRoutine;
NTSTATUS PparallelDeselectRoutine(
[in] PVOID DeselectContext,
[in] PVOID DeselectCommand
)
{...}
Parameter
[in] DeselectContext
Penunjuk ke ekstensi perangkat dari objek perangkat fungsional (FDO) yang mewakili port paralel.
[in] DeselectCommand
Penunjuk ke struktur PARALLEL_1284_COMMAND. Pemanggil menentukan anggota berikut:
ID
Menentukan ID perangkat 1284.3 (nol atau 1).
CommandFlags
Menentukan bitwise OR dari nol atau beberapa bendera berikut:
Nilai | Deskripsi |
---|---|
PAR_END_OF_CHAIN_DEVICE | Menentukan perangkat akhir rantai. |
PAR_HAVE_PORT_KEEP_PORT | Menentukan bahwa port tetap dialokasikan. |
Mengembalikan nilai
Menampilkan kode | Deskripsi |
---|---|
|
Perangkat tidak dipilih. |
|
ID perangkat yang ditentukan tidak valid. |
|
Driver fungsi yang disediakan sistem untuk port paralel tidak dapat membatalkan pilihan perangkat. |
Keterangan
Untuk mendapatkan penunjuk ke panggilan balik PPARALLEL_DESELECT_ROUTINE yang disediakan sistem, driver mode kernel menggunakan permintaan IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO , yang mengembalikan struktur PARALLEL_PNP_INFORMATION . Anggota DeselectDevice dari struktur PARALLEL_PNP_INFORMATION adalah penunjuk ke panggilan balik ini.
Driver mode kernel dapat menggunakan permintaan IOCTL_INTERNAL_DESELECT_DEVICE atau panggilan balik PPARALLEL_CLEAR_CHIP_MODE untuk membatalkan pilihan perangkat pada port paralel yang diwakili oleh port paralel. Untuk membatalkan pilihan perangkat, penelepon harus memiliki port paralel yang dialokasikan. Jika pemanggil tidak mengatur bendera PAR_HAVE_PORT_KEEP_PORT, driver fungsi yang disediakan sistem untuk port paralel membebaskan port paralel setelah membatalkan pilihan perangkat.
Untuk informasi selengkapnya, lihat Memilih dan Membatalkan Pilihan Perangkat IEEE 1284 yang Dilampirkan ke ParallelPort.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | parallel.h (termasuk Parallel.h) |
IRQL | <=DISPATCH_LEVEL |