struktur EMULATOR_ACCESS_ENTRY (dispmprt.h)

Artikel
08/07/2023

Struktur EMULATOR_ACCESS_ENTRY menentukan elemen dalam array EmulatorAccessEntries yang disiapkan dalam struktur VIDEO_PORT_CONFIG_INFO oleh driver adaptor yang kompatibel dengan VGA (SVGA) pada platform sistem operasi berbasis NT x86.

Sintaks

typedef struct _EMULATOR_ACCESS_ENTRY {
  ULONG                     BasePort;
  ULONG                     NumConsecutivePorts;
  EMULATOR_PORT_ACCESS_TYPE AccessType;
  UCHAR                     AccessMode;
  UCHAR                     StringSupport;
  PVOID                     Routine;
} EMULATOR_ACCESS_ENTRY, *PEMULATOR_ACCESS_ENTRY;

Anggota

BasePort

Menentukan alamat fisik relatif bus dari port I/O atau port yang akan dikaitkan dengan emulator V86. Nilai dan rentang port ini harus berada dalam rentang akses port I/O yang sudah diklaim dalam registri oleh VideoPortGetAccessRanges atau VideoPortVerifyAccessRanges.

NumConsecutivePorts

Menentukan jumlah port berturut-turut yang akan dikaitkan oleh emulator V86, mulai dari BasePort. Nilai ini ditentukan oleh lebar setiap port I/O yang dikaitkan. Misalnya, jika alamat port 0x3C0 dan 0x3C1 dikaitkan sebagai satu port yang dapat diatasi USHORT, nilai ini harus 1.

AccessType

Menentukan ukuran data yang ditransfer melalui port I/O yang diberikan sebagai salah satu Uchar, Ulong, atau Ushort.

AccessMode

Menentukan bagaimana port I/O yang diberikan dapat diakses sebagai satu atau kombinasi (ORed) dari nilai berikut:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Rentang port I/O harus dapat diakses dalam setidaknya salah satu mode sebelumnya.

StringSupport

Menunjukkan apakah fungsi SvgaHwIoPortXxx yang disediakan driver mendukung akses string dalam kasus di mana banyak nilai AccessType yang diberikan "dipompa" melalui port I/O secara berturut-turut. Jika anggota ini diatur ke TRUE, anggota Rutin harus menentukan titik masuk fungsi SvgaHwIoPortXxxString yang disediakan driver miniport.

Routine

Penunjuk ke SvgaHwIoPortXxx driver miniport yang menangani akses ke port atau port yang dijelaskan dalam struktur ini.

Keterangan

Driver miniport perangkat keras video SVGA yang kompatibel dengan VGA di mesin berbasis x86 harus menentukan rentang akses emulator, yang dapat disiapkan driver miniport yang kompatibel dengan VGA dengan VideoPortSetTrappedEmulatorPorts untuk diakses langsung dari aplikasi MS-DOS layar penuh untuk I/O yang lebih cepat. Driver semacam itu harus menyediakan serangkaian fungsi SvgaHwIoPortXxx untuk memvalidasi urutan INs yang dikeluarkan aplikasi, INSB/INSW/INSDs, OUTs, dan/atau OUTSB/OUTSW/OUTSDs ke setiap rentang port I/O tersebut.

Data di setiap elemen jenis EMULATOR_ACCESS_ENTRY digunakan untuk menentukan port I/O mana (lokasi memori tempat register adaptor dapat diakses) dalam rentang akses driver miniport telah diambil alih (dikaitkan) oleh emulator V86 pada platform berbasis x86. Nilai yang ditulis ke lokasi ini oleh aplikasi MS-DOS layar penuh terjebak dan diteruskan ke fungsi SvgaHwIoPortXxx driver miniport yang sesuai untuk validasi sebelum ditulis atau dibaca dari adaptor video. Namun, driver miniport dapat memungkinkan aplikasi untuk langsung mengakses rentang port I/O tertentu dengan memanggil VideoPortSetTrappedEmulatorPorts untuk meningkatkan performa.