PDRIVER_IO_PORT_USHORT fungsi panggilan balik (video.h)

Artikel
02/26/2024

SvgaHwIoPortUshort menjebak rentang port I/O tempat aplikasi MS-DOS layar penuh dalam mesin berbasis x86 mengirim urutan data berukuran USHORT.

Sintaks

PDRIVER_IO_PORT_USHORT PdriverIoPortUshort;

VP_STATUS PdriverIoPortUshort(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PUSHORT Data
)
{...}

Parameter

Context

Menentukan nilai konteks miniport yang ditentukan driver yang ditetapkan di anggota EmulatorAccessEntriesContext dari VIDEO_PORT_CONFIG_INFO.

Port

Menentukan port I/O yang dipetakan yang akan terperangkap.

AccessMode

Menentukan jenis akses yang diizinkan, yang bisa berupa satu atau kombinasi (ORed) dari nilai berikut:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Arahkan ke data USHORT yang akan ditransfer.

Nilai kembali

SvgaHwIoPortUshort mengembalikan status akhir operasi.

Keterangan

Hanya driver miniport adaptor SVGA yang kompatibel dengan VGA yang memiliki fungsi SvgaHwIoPortXxx . (Lihat Fungsi SVGA.)

SvgaHwIoPortUshort mencegat akses rentang apa pun yang dicoba oleh aplikasi MS-DOS layar penuh yang mengeluarkan salah satu atau kedua instruksi OUT DX, AX dan IN AX, DX.

Jika driver miniport mengaktifkan rentang Port untuk akses langsung dengan memanggil VideoSetTrappedEmulatorPorts, fungsi SvgaHwIoPortUshort-nya tidak akan dipanggil. Aplikasi seperti itu kemudian akan memiliki akses langsung ke rentang port I/O, kecuali driver miniport menonaktifkan rentang Port dengan panggilan lain ke VideoSetTrappedEmulatorPorts.

Jika satu atau beberapa instruksi X86 IN atau OUT yang dikeluarkan aplikasi dapat memengaruhi status register sequencer adapter yang kompatibel dengan VGA, register output lain-lain, atau register khusus adapter dan, sehingga menyebabkan mesin macet, driver miniport tidak boleh mengaktifkan port untuk akses langsung dengan memanggil VideoPortSetTrappedEmulatorPorts.

SvgaHwIoPortUshort harus menyangga instruksi berikutnya dari aplikasi dan memeriksa bahwa tidak ada yang dapat menggantung komputer. Jika aplikasi mengeluarkan urutan instruksi yang mungkin menggantung komputer, SvgaHwIoPortUshort harus membuang instruksi yang di-buffer. Jika tidak, itu harus mengeluarkannya, USHORT pada satu waktu, ke port I/O yang ditentukan dan dipetakan.

SvgaHwIoPortUshort harus dibuat dapat di-pageable.