PDRIVER_IO_PORT_ULONG fungsi panggilan balik (video.h)

Artikel
03/01/2024

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

Sintaks

PDRIVER_IO_PORT_ULONG PdriverIoPortUlong;

VP_STATUS PdriverIoPortUlong(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PULONG 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 ULONG yang akan ditransfer.

Nilai kembali

SvgaHwIoPortUlong mengembalikan status akhir operasi.

Keterangan

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

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

Jika driver miniport mengaktifkan rentang Port untuk akses langsung dengan memanggil VideoSetTrappedEmulatorPorts, fungsi SvgaHwIoPortUlong-nya tidak akan dipanggil. Aplikasi seperti itu kemudian akan memiliki akses langsung ke rentang port I/O, kecuali driver miniport menonaktifkan rentang 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.

SvgaHwIoPortUlong harus buffer instruksi berikutnya dari aplikasi dan periksa apakah tidak ada yang dapat menggantung komputer. Jika aplikasi mengeluarkan urutan instruksi yang mungkin menggantung komputer, SvgaHwIoPortUlong harus membuang instruksi yang di-buffer. Jika tidak, itu harus mengeluarkannya, ULONG pada satu waktu, ke port I/O yang ditentukan dan dipetakan.

SvgaHwIoPortUlong harus dibuat dapat halaman.