struttura D3DDEVICEDESC_V1 (d3dhal.h)

Articolo
03/08/2023

D3DDeviceDesc_V1 è obsoleto in DirectX 8.0 e versioni successive; vedere Osservazioni. Questa struttura descrive le funzionalità 3D di un dispositivo.

Sintassi

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;

Members

dwSize

Specifica le dimensioni in byte della struttura D3DDEVICEDESC_V1.

dwFlags

Identifica i membri di questa struttura che contengono dati validi. Questo membro può essere un OR bit per bit di uno dei valori seguenti:

Valore	Significato
D3DDD_BCLIPPING	Il membro bClipping contiene dati validi.
D3DDD_COLORMODEL	Il membro dcmColorModel contiene dati validi.
D3DDD_DEVCAPS	Il membro dwDevCaps contiene dati validi.
D3DDD_DEVICERENDERBITDEPTH	DwDeviceRenderBitDepthmember contiene dati validi.
D3DDD_DEVICEZBUFFERBITDEPTH	DwDeviceZBufferBitDepthmember contiene dati validi.
D3DDD_LIGHTINGCAPS	Il membro dlcLightingCaps contiene dati validi.
D3DDD_LINECAPS	Il membro dpcLineCaps contiene dati validi.
D3DDD_MAXBUFFERSIZE	Il membro dwMaxBufferSize contiene dati validi.
D3DDD_MAXVERTEXCOUNT	Il membro dwMaxVertexCount contiene dati validi.
D3DDD_TRANSFORMCAPS	Il membro dtcTransformCaps contiene dati validi.
D3DDD_TRICAPS	Il membro dpcTriCaps contiene dati validi.

dcmColorModel

Specifica il modello di colore del dispositivo.

dwDevCaps

Identifica le funzionalità del dispositivo. Questo membro può essere un OR bit per bit di uno dei valori seguenti:

Valore	Significato
D3DDEVCAPS_CANBLTSYSTONONLOCAL	Il dispositivo supporta un TexBlt dalla memoria di sistema alla memoria video secondaria.
D3DDEVCAPS_CANRENDERAFTERFLIP	Il dispositivo può accodamento dei comandi di rendering dopo un'inversione di pagina. I dispositivi devono supportare questa funzionalità in Windows 2000 e versioni successive, vale a dire che il driver imposterà sempre questo flag.
D3DDEVCAPS_DRAWPRIMITIVES2	Il dispositivo può supportare D3dDrawPrimitives2 .
D3DDEVCAPS_DRAWPRIMITIVES2EX	Il dispositivo può supportare Extended D3dDrawPrimitives2 ; ad esempio un driver conforme a DX7.
D3DDEVCAPS_DRAWPRIMTLVERTEX	Il dispositivo può disegnare primitive TLVERTEX. Questo flag è obsoleto, ma deve essere impostato dal driver.
D3DDEVCAPS_EXECUTESYSTEMMEMORY	Il dispositivo può usare buffer di esecuzione dalla memoria di sistema. Il driver deve sempre impostare questo bit.
D3DDEVCAPS_EXECUTEVIDEOMEMORY	Il dispositivo può usare i buffer di esecuzione dalla memoria visualizzata. Il driver non deve mai impostare questo bit.
D3DDEVCAPS_FLOATTLVERTEX	Il dispositivo accetta dati dei vertici posttransform a virgola mobile. Questo flag è obsoleto, ma deve essere impostato dal driver.
D3DDEVCAPS_HWRASTERIZATION	Il dispositivo ha accelerazione hardware per la rasterizzazione.
D3DDEVCAPS_HWTRANSFORMANDLIGHT	Il dispositivo può supportare la trasformazione e l'illuminazione nell'hardware. D3DDEVCAPS_DRAWPRIMITIVES2EX devono essere impostati anche.
D3DDEVCAPS_SEPARATETEXTUREMEMORIES	Il dispositivo esegue il texturing da pool di memoria separati. L'impostazione di questo bit di funzionalità indica a DirectX 8.0 e versioni successive delle applicazioni disabilitate dall'uso simultaneo di più trame.
D3DDEVCAPS_SORTDECREASINGZ	Il dispositivo necessita di dati ordinati per ridurre la profondità.
D3DDEVCAPS_SORTEXACT	Il dispositivo necessita di dati ordinati esattamente.
D3DDEVCAPS_SORTINCREASINGZ	Il dispositivo necessita di dati ordinati per aumentare la profondità.
D3DDEVCAPS_TEXTURENONLOCALVIDEOMEMORY	Il dispositivo può eseguire trame dalla memoria video non locale.
D3DDEVCAPS_TLVERTEXSYSTEMMEMORY	Il dispositivo può usare buffer dalla memoria di sistema per vertici trasformati e illuminati. Questo flag è obsoleto, ma deve essere impostato dal driver.
D3DDEVCAPS_TLVERTEXVIDEOMEMORY	Il dispositivo può usare buffer dalla memoria di visualizzazione per vertici trasformati e illuminati. Questo flag è obsoleto e non deve essere impostato dal driver.
D3DDEVCAPS_TEXTURESYSTEMMEMORY	Il dispositivo può recuperare trame dalla memoria di sistema.
D3DDEVCAPS_TEXTUREVIDEOMEMORY	Il dispositivo può recuperare trame dalla memoria del dispositivo.

dtcTransformCaps

Specifica una struttura D3DTRANSFORMCAPS che specifica le funzionalità di trasformazione del dispositivo. Il driver deve impostare il membro dwCaps di tale struttura su zero.

bClipping

Impostare su TRUE dal driver se il dispositivo può eseguire il ritaglio 3D.

dlcLightingCaps

Specifica le funzionalità di illuminazione del dispositivo. Si tratta di una struttura D3DLIGHTINGCAPS . Il driver deve impostare i membri dwCaps, dwLightingModel e dwNumLights di tale struttura su zero.

dpcLineCaps

Specifica una struttura D3DPRIMCAPS che definisce le funzionalità di disegno del dispositivo per le primitive di linea.

dpcTriCaps

Specifica una struttura D3DPRIMCAPS che definisce le funzionalità di disegno del dispositivo per le primitive di triangolo.

dwDeviceRenderBitDepth

Specifica la profondità di bit del rendering del dispositivo. Questo membro può essere un OR bit per bit delle costanti di profondità di bit DirectDraw seguenti: DDBD_8, DDBD_16, DDBD_24 o DDBD_32.

dwDeviceZBufferBitDepth

Specifica la profondità di bit del buffer z del dispositivo. Questo membro può essere un OR bit per bit delle costanti di profondità di bit DirectDraw seguenti: DDBD_8, DDBD_16, DDBD_24 o DDBD_32.

dwMaxBufferSize

Deve essere impostato su zero.

dwMaxVertexCount

DirectX 7 e versioni successive

DirectX 6

Commenti

Questa struttura è stata sostituita da D3DCAPS8 (vedere la documentazione di DirectX 8.0 SDK) per i runtime DirectX 8.0 e versioni successive, ma è necessaria per la compatibilità del runtime legacy (DirectX 7.0 e versioni precedenti). Per informazioni dettagliate, vedere Reporting DirectX 8.0 Style Direct3D Capabilities .See Reporting DirectX 8.0 Style Direct3D Capabilities.

La funzione DrvGetDirectDrawInfo del driver restituisce queste informazioni nella struttura D3DHAL_GLOBALDRIVERDATA a cui punta il membro lpD3DGlobalDriverData della struttura DD_HALINFO .

Il runtime Direct3D costruisce la struttura di D3DDEVICEDESC7 a livello di applicazione (documentata nella documentazione Microsoft Windows SDK) dalle informazioni restituite nella struttura D3DDEVICEDESC_V1 e le funzionalità estese sottoposte a query tramite la funzione DdGetDriverInfo del driver. Anche se alcuni flag dwDevCaps sono obsoleti a livello di driver, il driver deve impostarli in modo appropriato affinché le applicazioni funzionino correttamente.