D3DDEVICEDESC_V1 Struktur (d3dhal.h)

Artikel
02/06/2025

D3DDeviceDesc_V1 ist in DirectX 8.0 und höheren Versionen veraltet; siehe Hinweise. Diese Struktur beschreibt die 3D-Funktionen eines Geräts.

Syntax

typedef struct _D3DDeviceDesc_V1 {
  DWORD            dwSize;
  DWORD            dwFlags;
  D3DCOLORMODEL    dcmColorModel;
  DWORD            dwDevCaps;
  D3DTRANSFORMCAPS dtcTransformCaps;
  BOOL             bClipping;
  D3DLIGHTINGCAPS  dlcLightingCaps;
  D3DPRIMCAPS      dpcLineCaps;
  D3DPRIMCAPS      dpcTriCaps;
  DWORD            dwDeviceRenderBitDepth;
  DWORD            dwDeviceZBufferBitDepth;
  DWORD            dwMaxBufferSize;
  DWORD            dwMaxVertexCount;
} D3DDEVICEDESC_V1, *LPD3DDEVICEDESC_V1;

Angehörige

dwSize

Gibt die Größe in Byte dieser D3DDEVICEDESC_V1 Struktur an.

dwFlags

Identifiziert die Member dieser Struktur, die gültige Daten enthalten. Dieses Element kann ein bitweiser ODER einer der folgenden Werte sein:

Wert	Bedeutung
D3DDD_BCLIPPING	Das bClipping-Element enthält gültige Daten.
D3DDD_COLORMODEL	Das DcmColorModel-Element enthält gültige Daten.
D3DDD_DEVCAPS	Das dwDevCaps-Element enthält gültige Daten.
D3DDD_DEVICERENDERBITDEPTH	Die dwDeviceRenderBitDepthmember enthält gültige Daten.
D3DDD_DEVICEZBUFFERBITDEPTH	Die dwDeviceZBufferBitDepthmember enthält gültige Daten.
D3DDD_LIGHTINGCAPS	Das dlcLightingCaps-Element enthält gültige Daten.
D3DDD_LINECAPS	Das dpcLineCaps-Element enthält gültige Daten.
D3DDD_MAXBUFFERSIZE	Das dwMaxBufferSize-Element enthält gültige Daten.
D3DDD_MAXVERTEXCOUNT	Das dwMaxVertexCount-Element enthält gültige Daten.
D3DDD_TRANSFORMCAPS	Das Element "dtcTransformCaps" enthält gültige Daten.
D3DDD_TRICAPS	Das dpcTriCaps-Element enthält gültige Daten.

dcmColorModel

Gibt das Farbmodell des Geräts an.

dwDevCaps

Identifiziert die Funktionen des Geräts. Dieses Element kann ein bitweiser ODER einer der folgenden Werte sein:

Wert	Bedeutung
D3DDEVCAPS_CANBLTSYSTONONLOCAL	Das Gerät unterstützt ein TexBlt vom Systemspeicher bis hin zum unterlokalen Videospeicher.
D3DDEVCAPS_CANRENDERAFTERFLIP	Das Gerät kann Renderingbefehle in die Warteschlange stellen, nachdem eine Seite gekippt wurde. Geräte müssen diese Funktion unter Windows 2000 und höher unterstützen, was bedeutet, dass der Treiber diese Kennzeichnung immer festlegen würde.
D3DDEVCAPS_DRAWPRIMITIVES2	Das Gerät kann D3dDrawPrimitives2 unterstützen.
D3DDEVCAPS_DRAWPRIMITIVES2EX	Das Gerät kann extended D3dDrawPrimitives2 unterstützen; d. h. ein DX7-kompatibler Treiber.
D3DDEVCAPS_DRAWPRIMTLVERTEX	Das Gerät kann TLVERTEX-Grundtypen zeichnen. Dieses Kennzeichen ist veraltet, muss jedoch vom Treiber festgelegt werden.
D3DDEVCAPS_EXECUTESYSTEMMEMORY	Das Gerät kann Ausführungspuffer aus dem Systemspeicher verwenden. Der Treiber muss dieses Bit immer festlegen.
D3DDEVCAPS_EXECUTEVIDEOMEMORY	Das Gerät kann Ausführungspuffer aus dem Anzeigespeicher verwenden. Der Treiber darf dieses Bit niemals festlegen.
D3DDEVCAPS_FLOATTLVERTEX	Das Gerät akzeptiert Gleitkommastellen für Posttransform-Vertexdaten. Dieses Kennzeichen ist veraltet, muss jedoch vom Treiber festgelegt werden.
D3DDEVCAPS_HWRASTERIZATION	Das Gerät verfügt über Hardwarebeschleunigung für die Rasterung.
D3DDEVCAPS_HWTRANSFORMANDLIGHT	Das Gerät kann Transformation und Beleuchtung in der Hardware unterstützen. D3DDEVCAPS_DRAWPRIMITIVES2EX müssen ebenfalls festgelegt werden.
D3DDEVCAPS_SEPARATETEXTUREMEMORIES	Das Gerät texturiert aus separaten Speicherpools. Wenn Sie dieses Funktionsbit festlegen, wird für DirectX 8.0 und höhere Versionen von Anwendungen angegeben, dass sie von der gleichzeitigen Verwendung mehrerer Texturen deaktiviert sind.
D3DDEVCAPS_SORTDECREASINGZ	Das Gerät benötigt Daten, die zum Verringern der Tiefe sortiert sind.
D3DDEVCAPS_SORTEXACT	Das Gerät benötigt genau sortierte Daten.
D3DDEVCAPS_SORTINCREASINGZ	Das Gerät benötigt Daten, die zur Erhöhung der Tiefe sortiert sind.
D3DDEVCAPS_TEXTURENONLOCALVIDEOMEMORY	Das Gerät kann texturen aus nicht lokalem Videospeicher.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY	Das Gerät kann Puffer aus dem Systemspeicher für transformierte und beleuchtete Scheitelpunkte verwenden. Dieses Kennzeichen ist veraltet, muss jedoch vom Treiber festgelegt werden.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY	Das Gerät kann Puffer aus dem Anzeigespeicher für transformierte und beleuchtete Scheitelpunkte verwenden. Dieses Kennzeichen ist veraltet und darf nicht vom Treiber festgelegt werden.
D3DDEVCAPS_TEXTURESYSTEMMEMORY	Das Gerät kann Texturen aus dem Systemspeicher abrufen.
D3DDEVCAPS_TEXTUREVIDEOMEMORY	Das Gerät kann Texturen aus dem Gerätespeicher abrufen.

dtcTransformCaps

Gibt eine D3DTRANSFORMCAPS Struktur an, die die Transformationsfunktionen des Geräts angibt. Der Treiber muss das dwCaps Member dieser Struktur auf Null festlegen.

bClipping

Wird vom Treiber auf TRUE festgelegt, wenn das Gerät 3D-Clipping ausführen kann.

dlcLightingCaps

Gibt die Beleuchtungsfunktionen des Geräts an. Dies ist eine D3DLIGHTINGCAPS Struktur. Der Treiber muss die dwCaps, dwLightingModel-und dwNumLights-Elemente dieser Struktur auf Null festlegen.

dpcLineCaps

Gibt eine D3DPRIMCAPS Struktur an, die die Zeichenfunktionen des Geräts für Liniengrundtypen definiert.

dpcTriCaps

Gibt eine D3DPRIMCAPS Struktur an, die die Zeichenfunktionen des Geräts für Dreiecksgrundtypen definiert.

dwDeviceRenderBitDepth

Gibt die Rendering-Bittiefe des Geräts an. Dieses Element kann eine bitweise ODER der folgenden DirectDraw-Bittiefekonstanten sein: DDBD_8, DDBD_16, DDBD_24 oder DDBD_32.

dwDeviceZBufferBitDepth

Gibt die Z-Puffer-Bittiefe des Geräts an. Dieses Element kann eine bitweise ODER der folgenden DirectDraw-Bittiefekonstanten sein: DDBD_8, DDBD_16, DDBD_24 oder DDBD_32.

dwMaxBufferSize

Muss auf Null festgelegt werden.

dwMaxVertexCount

DirectX 7 und höhere Versionen

DirectX 6

Bemerkungen

Diese Struktur wurde durch D3DCAPS8 (siehe DirectX 8.0 SDK-Dokumentation) für DirectX 8.0 und höhere Laufzeiten ersetzt, ist jedoch für die Kompatibilität der Legacylaufzeit (DirectX 7.0 und früher) erforderlich. Ausführliche Informationen finden Sie unter Reporting DirectX 8.0 Style Direct3D Capabilities.

Die DrvGetDirectDrawInfo-Funktion des Treibers gibt diese Informationen in der D3DHAL_GLOBALDRIVERDATA Struktur zurück, auf die das lpD3DGlobalDriverData Member der DD_HALINFO Struktur verweist.

Die Direct3D-Laufzeit erstellt die D3DDEVICEDESC7 Struktur auf Anwendungsebene (dokumentiert in der Microsoft Windows SDK-Dokumentation) aus den in der D3DDEVICEDESC_V1 Struktur zurückgegebenen Informationen und den erweiterten Funktionen, die über die DdGetDriverInfo-Funktion des Treibers abgefragt werden. Während einige der dwDevCaps Flags auf Treiberebene veraltet sind, muss der Treiber sie entsprechend festlegen, damit Anwendungen ordnungsgemäß funktionieren.