PPARALLEL_DESELECT_ROUTINE fungsi panggilan balik (parallel.h)

Artikel
02/26/2024

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
STATUS_SUCCESS	Perangkat tidak dipilih.
STATUS_INVALID_PARAMETER	ID perangkat yang ditentukan tidak valid.
STATUS_UNSUCCESSFUL	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.