Funzione EngDeviceIoControl (winddi.h)

Articolo
03/13/2024

La funzione EngDeviceIoControl invia un codice di controllo al driver video miniport specificato, causando l'esecuzione dell'operazione specificata dal dispositivo.

Sintassi

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
);

Parametri

[in] hDevice

Gestire il dispositivo che deve eseguire l'operazione.

[in] dwIoControlCode

Specifica il codice di controllo per l'operazione. I controlli I/O sono elencati e descritti in modo completo in Codici di controllo I/O del driver Video Miniport.

[in, optional] lpInBuffer

Puntatore a un buffer contenente i dati necessari per eseguire l'operazione. Questo parametro può essere NULL se il codice di controllo specifica un'operazione che non richiede dati di input.

[in] nInBufferSize

Specifica le dimensioni, in byte, di lpInBuffer.

[out, optional] lpOutBuffer

Puntatore a un buffer in cui vengono restituiti i dati di output dell'operazione. Questo parametro può essere NULL se il codice di controllo specifica un'operazione che non produce dati di output.

[in] nOutBufferSize

Specifica le dimensioni, in byte, di lpOutBuffer.

[out] lpBytesReturned

Puntatore a una DWORD che specifica le dimensioni effettive, in byte, dei dati restituiti in lpOutBuffer.

Valore restituito

Il valore restituito è un codice di errore definito dall'API Win32 a 32 bit.

Commenti

EngDeviceIoControl viene usato da un driver di visualizzazione per comunicare le richieste di I/O al driver miniport corrispondente. Questa funzione fornisce l'unico canale di comunicazione tra un driver di visualizzazione e miniport video.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	winddi.h (include Winddi.h)
Libreria	Win32k.lib
DLL	Win32k.sys

Vedi anche

VIDEO_REQUEST_PACKET

Condividi tramite