struttura EMULATOR_ACCESS_ENTRY (dispmprt.h)

Articolo
08/07/2023

La struttura EMULATOR_ACCESS_ENTRY specifica un elemento nella matrice EmulatorAccessEntries configurato nella struttura VIDEO_PORT_CONFIG_INFO dai driver di adattatori COMPATIBILI con VGA (SVGA) su piattaforme del sistema operativo basate su NT x86.

Sintassi

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;

Members

BasePort

Specifica l'indirizzo fisico relativo al bus della porta o delle porte di I/O da associare all'emulatore V86. Questo valore e l'intervallo di porte devono rientrare in un intervallo di accesso di porte di I/O già richieste nel Registro di sistema da VideoPortGetAccessRanges o VideoPortVerifyAccessRanges.

NumConsecutivePorts

Specifica il numero di porte consecutive da associare all'emulatore V86, a partire da BasePort. Questo valore è determinato dalla larghezza di ogni porta di I/O associato. Ad esempio, se gli indirizzi delle porte 0x3C0 e 0x3C1 vengono collegati come singola porta indirizzabile da USHORT, questo valore deve essere 1.

AccessType

Specifica le dimensioni dei dati trasferiti tramite la porta di I/O specificata come una di Uchar, Ulong o Ushort.

AccessMode

Specifica come è possibile accedere alla porta di I/O specificata come una o una combinazione (ORed) dei valori seguenti:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

L'intervallo di porte di I/O deve essere accessibile in almeno una delle modalità precedenti.

StringSupport

Indica se la funzione SvgaHwIoPortXxx fornita dal driver supporta gli accessi stringa nei casi in cui molti valori del tipo di accesso specificato vengono "pompati" tramite una porta di I/O consecutiva. Se questo membro è impostato su TRUE, il membro Routine deve specificare il punto di ingresso di una funzione SvgaHwIoPortXxxString fornita dal driver miniport.

Routine

Puntatore al miniport driver SvgaHwIoPortXxx che gestisce l'accesso alla porta o alle porte descritte in questa struttura.

Commenti

I driver miniport compatibili con VGA dell'hardware video SVGA nei computer basati su x86 devono definire intervalli di accesso dell'emulatore, che un driver miniport compatibile con VGA può essere configurato con VideoPortSetTrappedEmulatorPorts per l'accesso direttamente dalle applicazioni MS-DOS a schermo intero per operazioni di I/O più veloci. Un driver di questo tipo deve fornire un set di funzioni SvgaHwIoPortXxx per convalidare qualsiasi sequenza di funzioni IN, INSB/INSW/INSDs, OUTs e/o OUTSB/OUTSW/OUTSDper ogni intervallo di porte di I/O.

I dati in ogni elemento di tipo EMULATOR_ACCESS_ENTRY vengono usati per determinare quali porte di I/O (percorsi di memoria in cui sono accessibili i registri delle schede) negli intervalli di accesso del driver miniport sono stati acquisiti (collegati) dall'emulatore V86 sulle piattaforme basate su x86. I valori scritti in queste posizioni da applicazioni MS-DOS a schermo intero vengono intrappolati e inoltrati alla funzione SvgaHwIoPortXxx corrispondente del driver miniport per la convalida prima che vengano scritti o letti dalla scheda video. Tuttavia, il driver miniport può consentire all'applicazione di accedere direttamente a determinati intervalli di porte di I/O chiamando VideoPortSetTrappedEmulatorPorts per migliorare le prestazioni.