PDRIVER_IO_PORT_USHORT funzione di callback (video.h)

2025-02-07

SvgaHwIoPortUshort intercettare un intervallo di porte I/O a cui un'applicazione MS-DOS a schermo intero in un computer basato su x86 invia una sequenza di dati di dimensioni USHORT.

Sintassi

PDRIVER_IO_PORT_USHORT PdriverIoPortUshort;

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

Parametri

Context

Specifica il valore di contesto determinato dal driver miniport impostato nel EmulatorAccessEntriesContext membro di VIDEO_PORT_CONFIG_INFO.

Port

Specifica la porta di I/O mappata da intrappolare.

AccessMode

Specifica il tipo di accesso consentito, che può essere una o una combinazione (ORed) dei valori seguenti:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Puntatore ai dati USHORT da trasferire.

Valore restituito

SvgaHwIoPortUshort restituisce lo stato finale dell'operazione.

Osservazioni

Solo i driver miniport delle schede SVGA compatibili con VGA hanno funzioni SvgaHwIoPortXxx. Vedere funzioni SVGA.)

SvgaHwIoPortUshort intercetta qualsiasi accesso a intervalli tentati da un'applicazione MS-DOS a schermo intero che emette o entrambe le istruzioni OUT DX, AX e IN AX, DX.

Se il driver miniport abilita l'intervallo di porta per l'accesso diretto chiamando VideoSetTrappedEmulatorPorts, il relativo SvgaHwIoPortUshort funzione non verrà chiamata. Tale applicazione avrà quindi accesso diretto all'intervallo di porte di I/O, a meno che il driver miniport non disabiliti l'intervallo porta con un'altra chiamata a VideoSetTrappedEmulatorPorts.

Se una o più istruzioni di x86 rilasciate dall'applicazione in o OUT potrebbero influire sullo stato del registro sequencer compatibile con VGA, del registro di output varie o di qualsiasi registro specifico dell'adattatore e, di conseguenza, causare il blocco del computer, il driver miniport deve non abilitare la porta per l'accesso diretto chiamando VideoPortSetTrappedEmulatorPorts.

SvgaHwIoPortUshort deve memorizzare le istruzioni successive dall'applicazione e verificare che nessuno possa bloccare il computer. Se l'applicazione emette una sequenza di istruzioni che potrebbero bloccare il computer, SvgaHwIoPortUshort deve eliminare le istruzioni memorizzate nel buffer. In caso contrario, deve restituirli, un USHORT alla volta, alla porta di I/O specificata mappata.

SvgaHwIoPortUshort deve essere reso pageable.