EngDeviceIoControl-Funktion (winddi.h)

Die EngDeviceIoControl-Funktion sendet einen Steuercode an den angegebenen Video-Miniporttreiber, wodurch das Gerät den angegebenen Vorgang ausführt.

Syntax

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

Parameter

[in] hDevice

Handle an das Gerät, das den Vorgang ausführen soll.

[in] dwIoControlCode

Gibt den Steuerelementcode für den Vorgang an. Die E/A-Steuerelemente werden unter Video Miniport Driver I/O Control Codes (E/A-Steuerungscodes des Video-Miniporttreibers) aufgeführt und vollständig beschrieben.

[in, optional] lpInBuffer

Zeiger auf einen Puffer, der Daten enthält, die zum Ausführen des Vorgangs erforderlich sind. Dieser Parameter kann NULL sein, wenn der Steuercode einen Vorgang angibt, der keine Eingabedaten erfordert.

[in] nInBufferSize

Gibt die Größe von lpInBuffer in Bytes an.

[out, optional] lpOutBuffer

Zeiger auf einen Puffer, in dem die Ausgabedaten des Vorgangs zurückgegeben werden. Dieser Parameter kann NULL sein, wenn der Steuerelementcode einen Vorgang angibt, der keine Ausgabedaten erzeugt.

[in] nOutBufferSize

Gibt die Größe von lpOutBuffer in Bytes an.

[out] lpBytesReturned

Zeiger auf ein DWORD, das die tatsächliche Größe der in lpOutBuffer zurückgegebenen Daten in Bytes angibt.

Rückgabewert

Der Rückgabewert ist ein durch die Win32-API definierter 32-Bit-Fehlercode.

Hinweise

EngDeviceIoControl wird von einem Anzeigetreiber verwendet, um E/A-Anforderungen an den entsprechenden Miniporttreiber zu kommunizieren. Diese Funktion stellt den einzigen Kommunikationskanal zwischen einem Display- und Video-Miniporttreiber bereit.

Anforderungen

Weitere Informationen

VIDEO_REQUEST_PACKET