PDRIVER_IO_PORT_ULONG fonction de rappel (video.h)
SvgaHwIoPortUlong intercepte une plage de ports d’E/S à laquelle une application MS-DOS plein écran dans une machine x86 envoie une séquence de données de taille ULONG.
Syntaxe
PDRIVER_IO_PORT_ULONG PdriverIoPortUlong;
VP_STATUS PdriverIoPortUlong(
ULONG_PTR Context,
ULONG Port,
UCHAR AccessMode,
PULONG Data
)
{...}
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é à piéger.
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 les données ULONG à transférer.
Valeur retournée
SvgaHwIoPortUlong 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.)
SvgaHwIoPortUlong intercepte tout accès à la plage tenté par une application MS-DOS en plein écran qui émet l’une ou l’autre des instructions OUT DX, EAX et IN EAX, DX.
Si le pilote miniport active la plage de ports pour l’accès direct en appelant VideoSetTrappedEmulatorPorts, sa fonction SvgaHwIoPortUlong 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 avec un autre appel à VideoSetTrappedEmulatorPorts.
Si une ou plusieurs instructions x86 IN ou OUT émises par l’application peuvent affecter l’état du registre de séquenceurs d’adaptateurs compatible VGA, du registre de sortie divers ou d’un registre spécifique à l’adaptateur et, par conséquent, provoquer le blocage de l’ordinateur, le pilote miniport ne doit pas activer le port d’accès direct en appelant VideoPortSetTrappedEmulatorPorts.
SvgaHwIoPortUlong 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, SvgaHwIoPortUlong 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é.
SvgaHwIoPortUlong doit être rendu paginable.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | video.h (inclure Video.h) |