PDRIVER_IO_PORT_ULONG_STRING fonction de rappel (video.h)

Article
02/29/2024

SvgaHwIoPortUlongString intercepte une plage de ports d’E/S à laquelle une application MS-DOS plein écran dans un ordinateur x86 envoie une séquence de données de taille ULONG.

Syntaxe

PDRIVER_IO_PORT_ULONG_STRING PdriverIoPortUlongString;

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

Paramètres

Context

Spécifie la valeur de contexte déterminée par le pilote miniport qui a été définie dans le membre EmulatorAccessEntriesContext de VIDEO_PORT_CONFIG_INFO.

Port

Spécifie le port d’E/S mappé à intercepter.

AccessMode

Spécifie le type d’accès autorisé, qui peut être une ou une combinaison (ORed) des valeurs suivantes :

EMULATOR_READ_ACCESS
EMULATOR_WRITE_ACCESS

Data

Pointeur vers la chaîne de données ULONG à transférer. La chaîne est raccordée une valeur à la fois jusqu’à ce qu’elle soit utilisée.

DataLength

Spécifie le nombre de valeurs ULONG dans la chaîne.

Valeur retournée

SvgaHwIoPortUlongString retourne la status finale de l’opération.

Remarques

Seuls les pilotes miniport des adaptateurs SVGA compatibles VGA ont des fonctions SvgaHwIoPortXxx . (Voir SVGA Functions.)

SvgaHwIoPortUlongString intercepte tout accès à la plage tenté par une application MS-DOS en plein écran qui émet l’une ou l’autre des instructions REP OUTSD DX, ESI et REP INSD EDI, DX.

Si le pilote miniport active la plage de ports pour l’accès direct en appelant VideoSetTrappedEmulatorPorts, sa fonction SvgaHwIoPortUlongString n’est pas appelée. Une telle application aura alors un accès direct à la plage de ports d’E/S, sauf si le pilote miniport désactive la plage de ports avec un autre appel à VideoSetTrappedEmulatorPorts.

Si une ou plusieurs instructions INSD ou OUTSD x86 émises par l’application peuvent affecter l’état du registre de séquenceur d’adaptateur compatible VGA, du registre de sortie divers ou de tout registre spécifique à l’adaptateur et, par conséquent, provoquer le blocage de la machine, le pilote miniport ne doit pas activer le port pour l’accès direct en appelant VideoPortSetTrappedEmulatorPorts.

SvgaHwIoPortUlongString doit mettre en mémoire tampon les instructions suivantes de l’application et case activée qu’aucune ne peut bloquer la machine. Si l’application émet une séquence d’instructions qui peut bloquer la machine, SvgaHwIoPortUlongString doit ignorer les instructions mises en mémoire tampon. Sinon, il doit les générer, un ULONG à la fois, vers le port d’E/S mappé spécifié.

SvgaHwIoPortUlongString doit être rendu paginable.