DrvGetDirectDrawInfo-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvGetDirectDrawInfo-Funktion gibt die Funktionen der Grafikhardware zurück.

Syntax

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

Parameter

dhpdev

Handle für den PDEV , der von der DrvEnablePDEV-Routine des Treibers zurückgegeben wird.

pHalInfo

Verweist auf eine DD_HALINFO-Struktur , in der der Treiber die unterstützten Hardwarefunktionen zurückgeben soll.

pdwNumHeaps

Zeigt auf den Speicherort, an dem der Treiber die Anzahl der VIDEOMEMORY-Strukturen zurückgeben soll, auf die von pvmList verwiesen wird.

pvmList

Verweist auf ein Array von VIDEOMEMORY-Strukturen , in denen der Treiber Informationen zu jedem Anzeigespeicherblock zurückgeben soll, den er steuert. Der Treiber sollte diesen Parameter ignorieren, wenn er NULL ist.

pdwNumFourCCCodes

Verweist auf den Speicherort, an dem der Treiber die Anzahl der DWORDs zurückgeben soll, auf die pdwFourCC verweist.

pdwFourCC

Verweist auf ein Array von DWORDs, in dem der Treiber Informationen zu jedem fourcc zurückgeben soll, den er unterstützt. Der Treiber sollte diesen Parameter ignorieren, wenn er NULL ist.

Rückgabewert

DrvGetDirectDrawInfo gibt TRUE zurück, wenn es erfolgreich ist. Andernfalls wird FALSE zurückgegeben.

Hinweise

Die DrvGetDirectDrawInfo-Routine des Treibers sollte die folgenden Aktionen ausführen:

Wenn pvmList und pdwFourCCNULL sind:
1. Reservieren Sie den Bildschirmspeicher für directDraw.
2. Schreiben Sie die Anzahl der Treiberanzeigespeicherheaps und der unterstützten FOURCCs in pdwNumHeaps bzw . pdwNumFourCC.
Wenn pvmList und pdwFourCC nicht NULL sind:
1. Schreiben Sie die Anzahl der Treiberanzeigespeicherheaps und der unterstützten FOURCCs in pdwNumHeaps bzw . pdwNumFourCC.
2. Geben Sie für jede VIDEOMEMORY-Struktur in der Liste, auf die pvmList verweist, die entsprechenden Member ein, um einen bestimmten Abschnitt des Anzeigespeichers zu beschreiben. Die Liste der Strukturen enthält DirectDraw eine vollständige Beschreibung des Offscreenspeichers des Treibers.
Initialisieren Sie die Member der DD_HALINFO-Struktur mit treiberspezifischen Informationen wie folgt:
1. Initialisieren Sie die entsprechenden Member der VIDEOMEMORYINFO-Struktur in vmiData , um die allgemeinen Merkmale des Anzeigespeichers zu beschreiben.
2. Initialisieren Sie die entsprechenden Member der DDCORECAPS-Struktur in ddCaps , um die Funktionen der Hardware zu beschreiben.
3. Wenn der Treiber eine DdGetDriverInfo-Funktion implementiert, legen Sie GetDriverInfo so fest, dass auf sie verweist, und legen Sie dwFlags auf DDHALINFO_GETDRIVERINFOSET fest.