PDRIVER_IO_PORT_ULONG_STRING Rückruffunktion (video.h)

Artikel
03/05/2024

SvgaHwIoPortUlongString erfasst einen E/A-Portbereich, an den eine MS-DOS-Vollbildanwendung auf einem x86-basierten Computer eine Sequenz von Daten im ULONG-Format sendet.

Syntax

PDRIVER_IO_PORT_ULONG_STRING PdriverIoPortUlongString;

VP_STATUS PdriverIoPortUlongString(
  ULONG_PTR Context,
  ULONG Port,
  UCHAR AccessMode,
  PULONG Data,
  ULONG DataLength
)
{...}

Parameter

Context

Gibt den vom Miniporttreiber ermittelten Kontextwert an, der im EmulatorAccessEntriesContext-Member von VIDEO_PORT_CONFIG_INFO festgelegt wurde.

Port

Gibt den zugeordneten E/A-Port an, der abgefangen werden soll.

AccessMode

Gibt den Typ des zulässigen Zugriffs an, der eine oder eine Kombination (ORed) der folgenden Werte sein kann:

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Zeiger auf die zu übertragende ULONG-Datenzeichenfolge. Die Zeichenfolge wird jeweils einen Wert nach dem anderen eingehängt, bis sie alle verwendet wird.

DataLength

Gibt die Anzahl der ULONG-Werte in der Zeichenfolge an.

Rückgabewert

SvgaHwIoPortUlongString gibt die letzte status des Vorgangs zurück.

Hinweise

Nur Miniporttreiber von VGA-kompatiblen SVGA-Adaptern verfügen über SvgaHwIoPortXxx-Funktionen . (Siehe SVGA-Funktionen.)

SvgaHwIoPortUlongString fängt alle Bereichszugriffe ab, die von einer MS-DOS-Vollbildanwendung versucht werden, die entweder oder beide der Anweisungen REP OUTSD DX, ESI und REP INSD EDI, DX ausgibt.

Wenn der Miniporttreiber den Portbereich für den direkten Zugriff durch Aufruf von VideoSetTrappedEmulatorPorts aktiviert, wird die SvgaHwIoPortUlongString-Funktion nicht aufgerufen. Eine solche Anwendung hat dann direkten Zugriff auf den E/A-Portbereich, es sei denn, der Miniporttreiber deaktiviert den Portbereich mit einem weiteren Aufruf von VideoSetTrappedEmulatorPorts.

Wenn eine oder mehrere von der Anwendung ausgestellte x86-INSD- oder OUTSD-Anweisungen den Zustand des VGA-kompatiblen Adaptersequenzerregisters, des sonstigen Ausgaberegisters oder eines beliebigen adapterspezifischen Registers beeinflussen und dadurch den Computer hängen lassen, darf der Miniporttreiber den Port nicht für den direkten Zugriff aktivieren, indem VideoPortSetTrappedEmulatorPorts aufgerufen wird.

SvgaHwIoPortUlongString muss nachfolgende Anweisungen aus der Anwendung puffern und überprüfen, ob keine den Computer hängen kann. Wenn die Anwendung eine Sequenz von Anweisungen ausgibt, die den Computer hängen könnten, muss SvgaHwIoPortUlongString die gepufferten Anweisungen verwerfen. Andernfalls sollten sie jeweils ein ULONG-Element an den angegebenen, zugeordneten E/A-Port ausgeben.

SvgaHwIoPortUlongString sollte ausgelagert werden.