EngDeviceIoControl, fonction (winddi.h)

Article
08/27/2023

La fonction EngDeviceIoControl envoie un code de contrôle au pilote de miniport vidéo spécifié, ce qui entraîne l’exécution de l’opération spécifiée par l’appareil.

Syntaxe

ENGAPI DWORD EngDeviceIoControl(
  [in]            HANDLE  hDevice,
  [in]            DWORD   dwIoControlCode,
  [in, optional]  LPVOID  lpInBuffer,
  [in]            DWORD   nInBufferSize,
  [out, optional] LPVOID  lpOutBuffer,
  [in]            DWORD   nOutBufferSize,
  [out]           LPDWORD lpBytesReturned
);

Paramètres

[in] hDevice

Gérez l’appareil qui doit effectuer l’opération.

[in] dwIoControlCode

Spécifie le code de contrôle pour l’opération. Les contrôles d’E/S sont répertoriés et décrits en intégralité dans Codes de contrôle d’E/S du pilote Miniport vidéo.

[in, optional] lpInBuffer

Pointeur vers une mémoire tampon contenant les données requises pour effectuer l’opération. Ce paramètre peut être NULL si le code de contrôle spécifie une opération qui ne nécessite pas de données d’entrée.

[in] nInBufferSize

Spécifie la taille, en octets, de lpInBuffer.

[out, optional] lpOutBuffer

Pointeur vers une mémoire tampon dans laquelle les données de sortie de l’opération sont retournées. Ce paramètre peut être NULL si le code de contrôle spécifie une opération qui ne produit pas de données de sortie.

[in] nOutBufferSize

Spécifie la taille, en octets, de lpOutBuffer.

[out] lpBytesReturned

Pointeur vers un DWORD qui spécifie la taille réelle, en octets, des données retournées dans lpOutBuffer.

Valeur retournée

La valeur de retour est un code d’erreur 32 bits défini par l’API Win32.

Remarques

EngDeviceIoControl est utilisé par un pilote d’affichage pour communiquer les demandes d’E/S à son pilote miniport correspondant. Cette fonction fournit le seul canal de communication entre un écran et un pilote de miniport vidéo.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	winddi.h (inclure Winddi.h)
Bibliothèque	Win32k.lib
DLL	Win32k.sys

Voir aussi

VIDEO_REQUEST_PACKET

Partager via