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
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.

Persyaratan

   
Target Platform Desktop
Header parallel.h (termasuk Parallel.h)
IRQL <=DISPATCH_LEVEL

Lihat juga

IOCTL_INTERNAL_SELECT_DEVICE

PPARALLEL_TRY_SELECT_ROUTINE

IOCTL_INTERNAL_DESELECT_DEVICE

PARALLEL_PNP_INFORMATION