D3DDEVICEDESC_V1 Struktur (d3dhal.h)

Artikel
03/08/2023

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;

Member

dwSize

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

dwFlags

Identifiziert die Member dieser Struktur, die gültige Daten enthalten. Dieser Member kann ein bitweises OR mit einem der folgenden Werte sein:

Wert	Bedeutung
D3DDD_BCLIPPING	Der bClipping-Member 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	DwDeviceRenderBitDepthmember enthält gültige Daten.
D3DDD_DEVICEZBUFFERBITDEPTH	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 dtcTransformCaps-Element 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. Dieser Member kann ein bitweises OR mit einem der folgenden Werte sein:

Wert	Bedeutung
D3DDEVCAPS_CANBLTSYSTONONLOCAL	Das Gerät unterstützt einen TexBlt vom Systemspeicher in den sublokalen Videospeicher.
D3DDEVCAPS_CANRENDERAFTERFLIP	Das Gerät kann Renderingbefehle nach einem Seitendrehen in die Warteschlange stellen. Geräte müssen diese Funktion unter Windows 2000 und höher unterstützen, was bedeutet, dass der Treiber dieses Flag 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 Flag ist veraltet, muss aber 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 Gleitkommadaten für Posttransform-Vertexdaten. Dieses Flag ist veraltet, muss aber vom Treiber festgelegt werden.
D3DDEVCAPS_HWRASTERIZATION	Das Gerät verfügt über Hardwarebeschleunigung für die Rasterisierung.
D3DDEVCAPS_HWTRANSFORMANDLIGHT	Das Gerät kann Transformation und Beleuchtung in Hardware unterstützen. D3DDEVCAPS_DRAWPRIMITIVES2EX muss ebenfalls festgelegt werden.
D3DDEVCAPS_SEPARATETEXTUREMEMORIES	Das Gerät texturiert aus separaten Speicherpools. Das Festlegen dieses Funktionsbits gibt für DirectX 8.0 und höhere Versionen von Anwendungen an, dass sie nicht gleichzeitig mehrere Texturen verwenden können.
D3DDEVCAPS_SORTDECREASINGZ	Das Gerät benötigt Daten, die sortiert werden, um die Tiefe zu verringern.
D3DDEVCAPS_SORTEXACT	Das Gerät benötigt Genau sortierte Daten.
D3DDEVCAPS_SORTINCREASINGZ	Das Gerät benötigt sortierte Daten, um die Tiefe zu erhöhen.
D3DDEVCAPS_TEXTURENONLOCALVIDEOMEMORY	Das Gerät kann eine Textur aus nicht lokalem Videospeicher erstellen.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY	Das Gerät kann Puffer aus dem Systemspeicher für transformierte und beleuchtete Scheitelpunkte verwenden. Dieses Flag ist veraltet, muss aber vom Treiber festgelegt werden.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY	Das Gerät kann Puffer aus dem Anzeigespeicher für transformierte und beleuchtete Scheitelpunkte verwenden. Dieses Flag 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 den dwCaps-Member dieser Struktur auf 0 (null) festlegen.

bClipping

Legen Sie vom Treiber auf TRUE fest, 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 Elemente dwCaps, dwLightingModel und dwNumLights dieser Struktur auf Null festlegen.

dpcLineCaps

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

dpcTriCaps

Gibt eine D3DPRIMCAPS-Struktur an, die die Zeichnungsfunktionen des Geräts für Dreieckgrundtypen definiert.

dwDeviceRenderBitDepth

Gibt die Renderingbittiefe des Geräts an. Dieser Member kann ein bitweises OR der folgenden DirectDraw-Bittiefekonstanten sein: DDBD_8, DDBD_16, DDBD_24 oder DDBD_32.

dwDeviceZBufferBitDepth

Gibt die Z-Puffer-Bittiefe des Geräts an. Dieser Member kann ein bitweiser OR der folgenden DirectDraw-Bittiefenkonstanten sein: DDBD_8, DDBD_16, DDBD_24 oder DDBD_32.

dwMaxBufferSize

Muss auf 0 festgelegt werden.

dwMaxVertexCount

DirectX 7 und höhere Versionen

DirectX 6

Hinweise

Diese Struktur wurde durch D3DCAPS8 (siehe DirectX 8.0 SDK-Dokumentation) für DirectX 8.0 und höhere Runtimes ersetzt, ist aber für die Kompatibilität mit legacy Runtime (DirectX 7.0 und früher) erforderlich. Weitere Informationen finden Sie unter Reporting DirectX 8.0 Style Direct3D Capabilities( 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-Element der DD_HALINFO-Struktur verweist.

Die Direct3D-Runtime 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 dwDevCaps-Flags auf Treiberebene veraltet sind, muss der Treiber sie entsprechend festlegen, damit Anwendungen ordnungsgemäß funktionieren.