D3DHAL_D3DEXTENDEDCAPS struttura (d3dhal.h)

D3DHAL_D3DEXTENDEDCAPS descrive funzionalità 3D aggiuntive del driver.

Sintassi

typedef struct _D3DHAL_D3DEXTENDEDCAPS {
  DWORD    dwSize;
  DWORD    dwMinTextureWidth;
  DWORD    dwMaxTextureWidth;
  DWORD    dwMinTextureHeight;
  DWORD    dwMaxTextureHeight;
  DWORD    dwMinStippleWidth;
  DWORD    dwMaxStippleWidth;
  DWORD    dwMinStippleHeight;
  DWORD    dwMaxStippleHeight;
  DWORD    dwMaxTextureRepeat;
  DWORD    dwMaxTextureAspectRatio;
  DWORD    dwMaxAnisotropy;
  D3DVALUE dvGuardBandLeft;
  D3DVALUE dvGuardBandTop;
  D3DVALUE dvGuardBandRight;
  D3DVALUE dvGuardBandBottom;
  D3DVALUE dvExtentsAdjust;
  DWORD    dwStencilCaps;
  DWORD    dwFVFCaps;
  DWORD    dwTextureOpCaps;
  WORD     wMaxTextureBlendStages;
  WORD     wMaxSimultaneousTextures;
  DWORD    dwMaxActiveLights;
  D3DVALUE dvMaxVertexW;
  WORD     wMaxUserClipPlanes;
  WORD     wMaxVertexBlendMatrices;
  DWORD    dwVertexProcessingCaps;
  DWORD    dwReserved1;
  DWORD    dwReserved2;
  DWORD    dwReserved3;
  DWORD    dwReserved4;
} D3DHAL_D3DEXTENDEDCAPS;

Members

dwSize

Specifica le dimensioni in byte di questa struttura D3DHAL_D3DEXTENDEDCAPS.

dwMinTextureWidth

Specificare la larghezza minima della trama, in pixel, supportata dal driver o dal dispositivo. Questo membro è in genere una potenza di 2. Questi membri vengono forniti come hint all'applicazione ed è responsabilità dell'applicazione regolare le dimensioni della trama quando necessario.

dwMaxTextureWidth

Specificare la larghezza massima della trama, in pixel, supportata dal driver o dal dispositivo. Questo membro è in genere una potenza di 2. Questi membri vengono forniti come hint all'applicazione ed è responsabilità dell'applicazione regolare le dimensioni della trama quando necessario.

dwMinTextureHeight

Specificare l'altezza minima della trama, in pixel, supportata dal driver. Questo membro è in genere una potenza di 2.

dwMaxTextureHeight

Specificare l'altezza massima della trama, in pixel, supportata dal driver. Questo membro è in genere una potenza di 2.

dwMinStippleWidth

Specificare la larghezza minima dello stipple, in pixel, supportata dal driver.

dwMaxStippleWidth

Specificare la larghezza massima di stipple, in pixel, supportata dal driver.

dwMinStippleHeight

Specificare l'altezza minima di stipple, in pixel, supportata dal driver.

dwMaxStippleHeight

Specificare l'altezza massima di stipple, in pixel, supportata dal driver.

dwMaxTextureRepeat

Specifica l'intervallo completo di bit interi (sottofractional) degli indici di trama postnormalizzati. Se il bit di D3DDEVCAPS_TEXREPEATNOTSCALEDBYSIZE è impostato, il numero di volte in cui è possibile eseguire il wrapping di una trama viene specificato da questo membro. Se il bit di D3DDEVCAPS_TEXREPEATNOTSCALEDBYSIZE non è impostato, il numero di volte in cui è possibile eseguire il wrapping di una trama viene assegnato dall'espressione: dwMaxTextureRepeat * (dimensioni della trama).

dwMaxTextureAspectRatio

Specifica il rapporto di aspetto massimo della trama supportato dall'hardware. Questo membro è in genere una potenza di 2. Questo rapporto di aspetto massimo viene fornito come misura dell'altezza della trama in pixel divisa per la larghezza in pixel o la relativa larghezza divisa per altezza, che produce il risultato maggiore. Ad esempio, una trama di 8192 pixel larga per 1 pixel alta o 1 pixel larga per 8192 alta non è valida con un dispositivo di visualizzazione che supporta solo un rapporto di aspetto massimo pari a 4092. Se l'hardware non è limitato in proporzioni, dwMaxTextureAspectRatio è maggiore di dwMaxTextureWidth e dwMaxTextureHeight.

dwMaxAnisotropy

Specifica il valore massimo valido per lo stato di rendering D3DRENDERSTATE_ANISOTROPY. Se l'hardware del driver non supporta il filtro anisotropico, il driver deve impostare questo membro su 1. L'impostazione di questo membro su 0 rappresenta un valore non valido.

dvGuardBandLeft

dvGuardBandTop

dvGuardBandRight

dvGuardBandBottom

Specificare le coordinate dello spazio dello schermo, in pixel, dell'area clip guard-band. L'angolo superiore sinistro di questo rettangolo contiene coordinate (dvGuardBandLeft, dvGuardBandTop). L'angolo inferiore sinistro ha coordinate (dvGuardBandRight, dvGuardBandBottom). Le coordinate all'interno di questo rettangolo, ma all'esterno del rettangolo di visualizzazione vengono ritagliate automaticamente.

dvExtentsAdjust

Specifica il numero di pixel necessari per regolare il rettangolo di estensione verso l'esterno per supportare i kernel antialiasing.

dwStencilCaps

Specifica le operazioni del buffer stencil supportate dal driver o dal dispositivo. Per altre descrizioni delle operazioni del buffer stencil illustrate nella tabella seguente, vedere D3DSTENCILOP nella documentazione di DirectX SDK. Si presuppone che le operazioni Stencil siano valide per tutti e tre gli stati di rendering dell'operazione buffer stencil (D3DRENDERSTATE_STENCILFAIL, D3DRENDERSTATE_STENCILPASS e D3DRENDERSTATE_STENCILZFAIL). Questo membro può essere un OR bit per bit di uno dei valori seguenti:

dwFVFCaps

Specifica il numero di coordinate di trama che il driver può elaborare. Questo valore può essere un intero nell'intervallo da 0 a 8, dove 0 indica che il driver non supporta la texturing, 1 indica che il driver può elaborare solo un set di coordinate di trama, 2 indica che il driver può elaborare due set di coordinate di trama e così via.

Un driver deve essere in grado di analizzare tutte le coordinate della trama presenti nei dati del vertice indipendentemente dal numero di coordinate di trama che il driver usa effettivamente. Il driver deve usare l'indice fornito con il valore D3DTSS_TEXCOORDINDEX dell'enumerazione D3DTEXTURESTAGESTATETYPE, descritto nella documentazione di DirectX SDK, per determinare quale coordinata trama impostata per usare durante il rendering.

dwTextureOpCaps

Specifica le operazioni di trama supportate dal dispositivo. Vedere D3DTEXTUREOP nella documentazione di DirectX SDK per le descrizioni delle operazioni di trama elencate nella tabella seguente. Questo membro può essere un OR bit per bit dei valori seguenti:

wMaxTextureBlendStages

Specifica il numero massimo di fasi di fusione delle trame supportate dal dispositivo.

wMaxSimultaneousTextures

Specifica il numero massimo di trame che possono essere associate contemporaneamente alle fasi di fusione delle trame per questo dispositivo. Ovvero , wMaxSimultaneousTextures specifica quante fasi della trama possono avere trame associate tramite il metodo lDirect3DDevice7::SetTexture . Per altre informazioni su questo metodo, vedere la documentazione Microsoft Windows SDK.

dwMaxActiveLights

Specifica il numero massimo di luci attive supportate dal dispositivo. Questo deve essere specificato solo nei driver che supportano la trasformazione e l'illuminazione hardware (e quindi specificare D3DDEVCAPS_HWTRANSFORMANDLIGHT nei relativi limiti di dispositivo).

dvMaxVertexW

Specifica l'intervallo W massimo supportato da questo dispositivo. Questo deve essere specificato solo nei driver che supportano il buffer W e quindi specificare D3DPRASTERCAPS_WBUFFER nei limiti di rasterizzazione. Le unità per i valori di profondità W dipendono dall'applicazione in esecuzione. Ad esempio, l'applicazione potrebbe specificare la profondità in metri.

wMaxUserClipPlanes

Specifica il numero massimo di piani clip definiti dall'utente supportati.

wMaxVertexBlendMatrices

Specifica il numero di matrici mondiali supportate per la fusione dei vertici.

dwVertexProcessingCaps

Specifica i limiti di elaborazione dei vertici supportati dal driver. Questo membro può essere un OR bit per bit dei valori seguenti:

dwReserved1

Riservato per l'utilizzo nel sistema.

dwReserved2

Riservato per l'utilizzo nel sistema.

dwReserved3

Riservato per l'utilizzo nel sistema.

dwReserved4

Riservato per l'utilizzo nel sistema.

Commenti

Il driver alloca e inizializza zero questa struttura e imposta i valori appropriati nei membri supportati. La funzione DdGetDriverInfo del driver restituisce un puntatore a questa struttura quando tale funzione viene chiamata con il GUID GUID_D3DExtendedCaps.

Quando il driver compila questa struttura, può impostare i valori per le funzionalità del buffer di esecuzione anche quando l'interfaccia usata per recuperare le funzionalità (ad esempio lDirect3DDevice3) non supporta i buffer di esecuzione.

Requisiti

Vedi anche

DdGetDriverInfo