Freigeben über


DD_HALINFO-Struktur (ddrawint.h)

Die DD_HALINFO-Struktur beschreibt die Funktionen der Hardware und des Treibers.

Syntax

typedef struct _DD_HALINFO {
  DWORD               dwSize;
  VIDEOMEMORYINFO     vmiData;
  DDNTCORECAPS        ddCaps;
  PDD_GETDRIVERINFO   GetDriverInfo;
  DWORD               dwFlags;
  LPVOID              lpD3DGlobalDriverData;
  LPVOID              lpD3DHALCallbacks;
  PDD_D3DBUFCALLBACKS lpD3DBufCallbacks;
} DD_HALINFO, *PDD_HALINFO;

Member

dwSize

Gibt die Größe dieser DD_HALINFO-Struktur in Bytes an.

vmiData

Gibt eine VIDEOMEMORYINFO-Struktur an, die den Speicher der Anzeige beschreibt.

ddCaps

Gibt eine DDNTCORECAPS-Struktur an, die treiberspezifische Funktionen enthält.

GetDriverInfo

Zeigt auf die DdGetDriverInfo-Funktion des Treibers. Diese Funktion wird aufgerufen, um weitere Microsoft DirectDraw-Treiberinformationen abzurufen. Dieses Element kann NULL sein.

dwFlags

Gibt die Erstellungsflags des Anzeigetreibers an. Dieses Element ist ein bitweiser OR mit einem der folgenden Werte:

Flag Bedeutung
DDHALINFO_ISPRIMARYDISPLAY Der Treiber ist der primäre Anzeigetreiber.
DDHALINFO_MODEXILLEGAL Diese Hardware unterstützt keine ModeX-Modi.
DDHALINFO_GETDRIVERINFOSET Das GetDriverInfo-Element ist festgelegt.
DDHALINFO_GETDRIVERINFO2 Der Treiber unterstützt die GetDriverInfo2-Variante von GetDriverInfo.

lpD3DGlobalDriverData

Verweist auf eine D3DHAL_GLOBALDRIVERDATA Struktur, die die 3D-Funktionen des Treibers und seines Geräts beschreibt.

lpD3DHALCallbacks

Zeigt auf die initialisierte D3DHAL_CALLBACKS-Struktur des Treibers.

lpD3DBufCallbacks

Wird nur von Treibern verwendet, die Vertex- und Befehlspufferzuordnung auf Treiberebene implementieren möchten. Dies geschieht in der Regel aus Leistungsgründen. Das lpD3DBufCallbacks-Element ist ein Zeiger auf eine DD_D3DBUFCALLBACKS Struktur, die der Treiber mit den Rückrufen ausfüllt, die zur Unterstützung von vom Treiber verwalteten Scheitelpunkten und Befehlspuffern verwendet werden. Dieses Element sollte normalerweise vom Treiber ignoriert werden.

Hinweise

GDI weist die DD_HALINFO-Struktur zu und initialisiert sie null und übergibt sie an die DrvGetDirectDrawInfo-Routine des Treibers, um mit treiberspezifischen Daten initialisiert zu werden.

Anforderungen

   
Kopfzeile ddrawint.h (include Winddi.h)

Weitere Informationen

D3DHAL_CALLBACKS

D3DHAL_GLOBALDRIVERDATA

DDCORECAPS

DD_D3DBUFCALLBACKS

DdGetDriverInfo

DrvGetDirectDrawInfo

VIDEOMEMORYINFO