EMULATOR_ACCESS_ENTRY struttura (miniport.h)

Articolo
08/07/2023

La struttura EMULATOR_ACCESS_ENTRY specifica un elemento nella matrice EmulatorAccessEntries configurata nella struttura VIDEO_PORT_CONFIG_INFO dai driver delle schede SVGA compatibili con VGA nelle piattaforme del sistema operativo basato 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 di I/O o da collegare dall'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 USHORT, questo valore deve essere 1.

AccessType

Specifica le dimensioni dei dati trasferiti tramite la porta di I/O specificata come uno 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 un driver miniport fornito da SvgaHwIoPortXxxString .

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 essere accessibile direttamente dalle applicazioni MS-DOS a schermo intero per i/O più veloci. Tale driver deve fornire un set di funzioni SvgaHwIoPortXxx per convalidare qualsiasi sequenza di applicazioni rilasciate INs, INSB/INSW/INSD s, OUTSB/OUTSB/OUTSW/OUTSDs a 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 (posizioni di memoria in cui sono accessibili i registri dell'adattatore) 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 prima di essere 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.