struttura DDCAPS_DX3 (ddraw.h)

La struttura DDCAPS rappresenta le funzionalità dell'hardware esposto tramite l'oggetto DirectDraw. Questa struttura contiene una struttura DDSCAPS2 utilizzata in questo contesto per descrivere i tipi di oggetti DirectDrawSurface che è possibile creare. Potrebbe non essere possibile creare contemporaneamente tutte le superfici descritte da queste funzionalità. Questa struttura viene utilizzata con il metodo IDirectDraw7::GetCaps .

Il file di intestazione Ddraw.h contiene più versioni di questa struttura, ad esempio DDCAPS_DX7. Per altre informazioni su come determinare la versione da utilizzare, vedere La sezione Note.

Sintassi

typedef struct _DDCAPS_DX3 {
  DWORD   dwSize;
  DWORD   dwCaps;
  DWORD   dwCaps2;
  DWORD   dwCKeyCaps;
  DWORD   dwFXCaps;
  DWORD   dwFXAlphaCaps;
  DWORD   dwPalCaps;
  DWORD   dwSVCaps;
  DWORD   dwAlphaBltConstBitDepths;
  DWORD   dwAlphaBltPixelBitDepths;
  DWORD   dwAlphaBltSurfaceBitDepths;
  DWORD   dwAlphaOverlayConstBitDepths;
  DWORD   dwAlphaOverlayPixelBitDepths;
  DWORD   dwAlphaOverlaySurfaceBitDepths;
  DWORD   dwZBufferBitDepths;
  DWORD   dwVidMemTotal;
  DWORD   dwVidMemFree;
  DWORD   dwMaxVisibleOverlays;
  DWORD   dwCurrVisibleOverlays;
  DWORD   dwNumFourCCCodes;
  DWORD   dwAlignBoundarySrc;
  DWORD   dwAlignSizeSrc;
  DWORD   dwAlignBoundaryDest;
  DWORD   dwAlignSizeDest;
  DWORD   dwAlignStrideAlign;
  DWORD   dwRops[DD_ROP_SPACE];
  DDSCAPS ddsCaps;
  DWORD   dwMinOverlayStretch;
  DWORD   dwMaxOverlayStretch;
  DWORD   dwMinLiveVideoStretch;
  DWORD   dwMaxLiveVideoStretch;
  DWORD   dwMinHwCodecStretch;
  DWORD   dwMaxHwCodecStretch;
  DWORD   dwReserved1;
  DWORD   dwReserved2;
  DWORD   dwReserved3;
  DWORD   dwSVBCaps;
  DWORD   dwSVBCKeyCaps;
  DWORD   dwSVBFXCaps;
  DWORD   dwSVBRops[DD_ROP_SPACE];
  DWORD   dwVSBCaps;
  DWORD   dwVSBCKeyCaps;
  DWORD   dwVSBFXCaps;
  DWORD   dwVSBRops[DD_ROP_SPACE];
  DWORD   dwSSBCaps;
  DWORD   dwSSBCKeyCaps;
  DWORD   dwSSBFXCaps;
  DWORD   dwSSBRops[DD_ROP_SPACE];
  DWORD   dwReserved4;
  DWORD   dwReserved5;
  DWORD   dwReserved6;
} DDCAPS_DX3;

Members

dwSize

Dimensioni della struttura, in byte. Questo membro deve essere inizializzato prima dell'utilizzo della struttura.

dwCaps

Questo valore è costituito da uno o più flag seguenti che specificano funzionalità hardware e driver.

DDCAPS_3D

L'hardware dello schermo ha accelerazione 3D.

DDCAPS_ALIGNBOUNDARYDEST

DirectDraw supporta solo i rettangoli di destinazione sovrapposti con l'asse x allineato ai limiti dwAlignBoundaryDest della superficie.

DDCAPS_ALIGNBOUNDARYSRC

DirectDraw supporta solo i rettangoli di origine sovrapposti con l'asse x allineato ai limiti dwAlignBoundarySrc della superficie.

DDCAPS_ALIGNSIZEDEST

DirectDraw supporta solo i rettangoli di destinazione di sovrapposizione le cui dimensioni dell'asse x, in pixel, sono multipli dwAlignSizeDest .

DDCAPS_ALIGNSIZESRC

DirectDraw supporta solo i rettangoli di origine di sovrapposizione le cui dimensioni dell'asse x, in pixel, sono multipli dwAlignSizeSrc .

DDCAPS_ALIGNSTRIDE

DirectDraw crea superfici di memoria di visualizzazione con un allineamento stride uguale al valore dwAlignStrideAlign.

DDCAPS_ALPHA

L'hardware di visualizzazione supporta superfici alfa-only.

DDCAPS_BANKSWITCHED

L'hardware dello schermo è commutato in banca ed è potenzialmente molto lento ad accesso casuale per visualizzare la memoria.

DDCAPS_BLT

L'hardware di visualizzazione è in grado di eseguire operazioni di trasferimento in blocchi di bit (bitblt).

DDCAPS_BLTCOLORFILL

L'hardware di visualizzazione è in grado di riempire i colori con un blitter.

DDCAPS_BLTDEPTHFILL

L'hardware di visualizzazione è in grado di riempire i buffer z con un blitter.

DDCAPS_BLTFOURCC

L'hardware di visualizzazione è in grado di convertire lo spazio dei colori durante le operazioni bitblt.

DDCAPS_BLTQUEUE

L'hardware di visualizzazione è in grado di eseguire operazioni bitblt asincrone.

DDCAPS_BLTSTRETCH

L'hardware di visualizzazione è in grado di estendersi durante le operazioni bitblt.

DDCAPS_CANBLTSYSMEM

L'hardware di visualizzazione è in grado di eseguire il blitting da o verso la memoria di sistema.

DDCAPS_CANCLIP

L'hardware di visualizzazione è in grado di ritagliare con blitting.

DDCAPS_CANCLIPSTRETCHED

L'hardware di visualizzazione è in grado di ritagliare durante l'estensione del blitting.

DDCAPS_COLORKEY

Supporta una forma di chiave di colore nelle operazioni di sovrapposizione o bitblt. Nel membro dwCKeyCaps sono disponibili informazioni più specifiche sulle funzionalità con chiave a colori.

DDCAPS_COLORKEYHWASSIST

La chiave di colore è parzialmente assistita dall'hardware. Ciò significa che potrebbero essere usate altre risorse (CPU o memoria video). Se questo bit non è impostato, è disponibile il supporto hardware completo.

DDCAPS_GDI

L'hardware di visualizzazione viene condiviso con GDI.

DDCAPS_NOHARDWARE

Non è disponibile alcun supporto hardware.

DDCAPS_OVERLAY

L'hardware di visualizzazione supporta le sovrimpressioni.

DDCAPS_OVERLAYCANTCLIP

L'hardware di visualizzazione supporta le sovrimpressioni, ma non può ritagliarle.

DDCAPS_OVERLAYFOURCC

L'hardware overlay è in grado di convertire lo spazio dei colori durante le operazioni di sovrimpressione.

DDCAPS_OVERLAYSTRETCH

L'hardware overlay è in grado di estendersi. I membri dwMinOverlayStretch e dwMaxOverlayStretch contengono dati validi.

DDCAPS_PALETTE

DirectDraw è in grado di creare e supportare oggetti DirectDrawPalette per superfici diverse dalla superficie primaria.

DDCAPS_PALETTEVSYNC

DirectDraw è in grado di aggiornare una tavolozza sincronizzata con l'aggiornamento verticale.

DDCAPS_READSCANLINE

L'hardware di visualizzazione è in grado di restituire la linea di analisi corrente.

DDCAPS_VBI

L'hardware di visualizzazione è in grado di generare un interrupt verticale vuoto.

DDCAPS_ZBLTS

Supporta l'uso di buffer z con operazioni bitblt.

DDCAPS_ZOVERLAYS

Supporta l'uso del metodo IDirectDrawSurface7::UpdateOverlayZOrder come valore z per le sovrimpressioni per controllare il livello.

dwCaps2

Questo valore è costituito da uno o più flag seguenti che specificano più funzionalità hardware e driver.

DDCAPS2_AUTOFLIPOVERLAY

La sovrimpressione può essere capovolta automaticamente alla superficie successiva nella catena di capovolgimento ogni volta che si verifica una porta video VSYNC, consentendo alla porta video e alla sovrimpressione di eseguire il doppio buffer del video senza sovraccarico della CPU. Questa opzione è valida solo quando la superficie riceve dati da una porta video. Se i dati della porta video non sono interlacciati o noninterlacciati, viene capovolto su ogni VSYNC. Se i dati vengono interleavati in memoria, viene capovolto in ogni altro VSYNC.

DDCAPS2_CANBOBHARDWARE

L'hardware di sovrimpressione può visualizzare ogni campo di un flusso video interlacciato singolarmente.

DDCAPS2_CANBOBINTERLEAVED

L'hardware di sovrimpressione può visualizzare ogni campo di un flusso video interlacciato singolarmente mentre è interleaved in memoria senza causare elementi che potrebbero verificarsi normalmente senza supporto hardware speciale. Questa opzione è valida solo quando la superficie riceve dati da una porta video e il video viene ingrandita almeno due volte nella direzione verticale.

DDCAPS2_CANBOBNONINTERLEAVED

L'hardware di sovrimpressione può visualizzare ogni campo di un flusso video interlacciato singolarmente, mentre non è interleaved in memoria senza causare elementi che normalmente si verificano senza supporto hardware speciale. Questa opzione è valida solo quando la superficie riceve dati da una porta video e il video viene ingrandita almeno due volte nella direzione verticale.

DDCAPS2_CANCALIBRATEGAMMA

Il sistema dispone di un calibratore installato che può regolare automaticamente la rampa gamma in modo che il risultato sia identico in tutti i sistemi con un calibratore. Per richiamare il calibratore quando si impostano nuovi livelli gamma, usare il flag DDSGR_CALIBRATE quando si chiama il metodo IDirectDrawGammaControl::SetGammaRamp . La calibrazione delle rampe gamma comporta un sovraccarico di elaborazione e non deve essere usata di frequente.

DDCAPS2_CANDROPZ16BIT

I valori RGBZ a 16 bit possono essere convertiti in valori RGB a 16 bit. Il sistema non supporta le conversioni a 8 bit.

DDCAPS2_CANFLIPODDEVEN

Il driver è in grado di eseguire operazioni di inversione dispari e pari, come specificato dai flag DDFLIP_ODD e DDFLIP_EVEN utilizzati con il metodo IDirectDrawSurface7::Flip .

DDCAPS2_CANMANAGETEXTURE

La gestione trame Direct3D usa questa funzionalità per decidere se inserire superfici gestite in memoria video non locale. Se la funzionalità è impostata, gestione trame inserisce superfici gestite in memoria video non locale. I driver che non possono eseguire trame dalla memoria video locale non devono impostare questa funzionalità.

DDCAPS2_CANRENDERWINDOWED

Il driver è in grado di eseguire il rendering in modalità finestra.

DDCAPS2_CERTIFIED

L'hardware di visualizzazione è certificato.

DDCAPS2_COLORCONTROLPRIMARY

La superficie primaria contiene controlli colore ,ad esempio gamma.

DDCAPS2_COLORCONTROLOVERLAY

La superficie di sovrapposizione contiene controlli colore ,ad esempio luminosità e nitidezza.

DDCAPS2_COPYFOURCC

Il driver supporta l'adattamento di qualsiasi superficie FOURCC a un'altra superficie dello stesso FOURCC.

DDCAPS2_FLIPINTERVAL

Il driver risponde ai flag DDFLIP_INTERVAL*. Per altre informazioni su questi flag, vedere IDirectDrawSurface7::Flip.

DDCAPS2_FLIPNOVSYNC

Il driver risponde al flag DDFLIP_NOVSYNC (per altre informazioni su questo flag, vedere IDirectDrawSurface7::Flip).

DDCAPS2_NO2DDURING3DSCENE

Le operazioni bidimensionali, ad esempio IDirectDrawSurface7::Blt e IDirectDrawSurface7::Lock , non possono essere eseguite su alcuna superficie usata da Direct3D tra le chiamate ai metodi BeginScene e EndScene .

DDCAPS2_NONLOCALVIDMEM

Il driver di visualizzazione supporta le superfici nella memoria video non locale.

DDCAPS2_NONLOCALVIDMEMCAPS

Le funzionalità bitblt per le superfici non locali di memoria video differiscono dalle superfici locali di memoria video. Se questo flag è presente, è presente anche il flag DDCAPS2_NONLOCALVIDMEM.

DDCAPS2_NOPAGELOCKREQUIRED

Le operazioni DMA bitblt sono supportate nelle superfici di memoria di sistema che non sono bloccate dalla pagina.

DDCAPS2_PRIMARYGAMMA

Supporta le rampe gamma dinamiche per la superficie primaria.

DDCAPS2_STEREO

Novità per DirectX 7.0. Attiva il bit dwSVCaps per supportare la modalità stereo. Il driver può eseguire stereo in almeno una modalità diversa dalla modalità corrente. L'applicazione può usare IDirectDraw7::GetDisplayMode o IDirectDraw7::EnumDisplayModes per ottenere informazioni stereo per modalità.

DDCAPS2_TEXMANINNONLOCALVIDMEM

Novità per DirectX 7.0. La gestione trame Direct3D usa questa funzionalità per decidere se inserire superfici gestite in memoria video non locale. Se la funzionalità è impostata, gestione trame inserisce superfici gestite in memoria video non locale. I driver che non possono eseguire trame dalla memoria video locale non devono impostare questa funzionalità.

DDCAPS2_VIDEOPORT

L'hardware di visualizzazione supporta video live.

DDCAPS2_WIDESURFACES

La superficie di visualizzazione supporta superfici più ampie della superficie primaria.

dwCKeyCaps

Questo valore è costituito da uno o più flag seguenti che specificano le funzionalità di chiave del colore.

DDCKEYCAPS_DESTBLT

Supporta la blitting trasparente con una chiave di colore che identifica i bit sostituibili della superficie di destinazione per i colori RGB.

DDCKEYCAPS_DESTBLTCLRSPACE

Supporta la blitting trasparente con uno spazio colore che identifica i bit sostituibili della superficie di destinazione per i colori RGB.

DDCKEYCAPS_DESTBLTCLRSPACEYUV

Supporta la blitting trasparente con uno spazio colore che identifica i bit sostituibili della superficie di destinazione per i colori YUV.

DDCKEYCAPS_DESTBLTYUV

Supporta la blitting trasparente con una chiave di colore che identifica i bit sostituibili della superficie di destinazione per i colori YUV.

DDCKEYCAPS_DESTOVERLAY

Supporta la sovrapposizione con il tasto colore dei bit sostituibili della superficie di destinazione da sovrapporre per i colori RGB.

DDCKEYCAPS_DESTOVERLAYCLRSPACE

Supporta uno spazio colore come chiave di colore per la destinazione dei colori RGB.

DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV

Supporta uno spazio colore come chiave di colore per la destinazione dei colori YUV.

DDCKEYCAPS_DESTOVERLAYONEACTIVE

Supporta un solo valore della chiave del colore di destinazione attiva per le superfici di sovrapposizione visibili.

DDCKEYCAPS_DESTOVERLAYYUV

Supporta la sovrapposizione, usando il tasto colore dei bit sostituibili della superficie di destinazione da sovrapporre per i colori YUV.

DDCKEYCAPS_NOCOSTOVERLAY

Indica che non ci sono compromessi per la larghezza di banda per l'uso della chiave di colore con una sovrimpressione.

DDCKEYCAPS_SRCBLT

Supporta la blitting trasparente, usando la chiave di colore per l'origine con questa superficie per i colori RGB.

DDCKEYCAPS_SRCBLTCLRSPACE

Supporta la blitting trasparente, usando uno spazio colori per l'origine con questa superficie per i colori RGB.

DDCKEYCAPS_SRCBLTCLRSPACEYUV

Supporta il blitting trasparente, usando uno spazio colori per l'origine con questa superficie per i colori YUV.

DDCKEYCAPS_SRCBLTYUV

Supporta la blitting trasparente, usando la chiave di colore per l'origine con questa superficie per i colori YUV.

DDCKEYCAPS_SRCOVERLAY

Supporta la sovrapposizione, usando la chiave di colore per l'origine con questa superficie di sovrapposizione per i colori RGB.

DDCKEYCAPS_SRCOVERLAYCLRSPACE

Supporta la sovrimpressione, usando uno spazio colore come chiave di colore di origine per la superficie di sovrapposizione per i colori RGB.

DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV

Supporta la sovrapposizione, usando uno spazio colore come chiave di colore di origine per la superficie di sovrapposizione per i colori YUV.

DDCKEYCAPS_SRCOVERLAYONEACTIVE

Supporta un solo valore della chiave del colore di origine attiva per le superfici di sovrapposizione visibili.

DDCKEYCAPS_SRCOVERLAYYUV

Supporta la sovrapposizione, usando la chiave di colore per l'origine con questa superficie di sovrapposizione per i colori YUV.

dwFXCaps

Questo valore è costituito da uno o più flag seguenti che specificano funzionalità di estensione ed effetti del driver.

DDFXCAPS_BLTALPHA

Supporta operazioni bitblt con fusione alfa.

DDFXCAPS_BLTARITHSTRETCHY

Usa operazioni aritmetiche, anziché tecniche di raddoppio dei pixel, per estendere e compattare le superfici durante un'operazione bitblt. Si verifica lungo l'asse y (verticalmente).

DDFXCAPS_BLTARITHSTRETCHYN

Usa operazioni aritmetiche, anziché tecniche di raddoppio dei pixel, per estendere e compattare le superfici durante un'operazione bitblt. Si verifica lungo l'asse y (verticalmente) e funziona solo per l'estensione integer (×1, ×2 e così via).

DDFXCAPS_BLTFILTER

Il driver può eseguire filtri per la ricostruzione della superficie per i bit con distorsione.

DDFXCAPS_BLTMIRRORLEFTRIGHT

Supporta il mirroring da sinistra a destra in un'operazione bitblt.

DDFXCAPS_BLTMIRRORUPDOWN

Supporta il mirroring dall'alto verso il basso in un'operazione bitblt.

DDFXCAPS_BLTROTATION

Supporta la rotazione arbitraria in un'operazione bitblt.

DDFXCAPS_BLTROTATION90

Supporta le rotazioni a 90 gradi in un'operazione bitblt.

DDFXCAPS_BLTSHRINKX

Supporta la compattazione arbitraria di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTSHRINKXN

Supporta la compattazione di numeri interi (×1, ×2 e così via) di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTSHRINKY

Supporta la compattazione arbitraria di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTSHRINKYN

Supporta la compattazione di numeri interi (×1, ×2 e così via) di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTSTRETCHX

Supporta l'estensione arbitraria di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTSTRETCHXN

Supporta l'estensione integer (×1, ×2 e così via) di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTSTRETCHY

Supporta l'estensione arbitraria di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTSTRETCHYN

Supporta l'estensione integer (×1, ×2 e così via) di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni bitblt.

DDFXCAPS_BLTTRANSFORM

Supporta trasformazioni geometriche (o distorsioni) per gli sprite blittati. Le trasformazioni non sono attualmente supportate per le operazioni bitblt esplicite.

DDFXCAPS_OVERLAYALPHA

Supporta la fusione alfa per le superfici sovrapposte.

DDFXCAPS_OVERLAYARITHSTRETCHY

Usa operazioni aritmetiche, anziché tecniche di raddoppio dei pixel, per estendere e compattare le superfici sovrapposte. Si verifica lungo l'asse y (verticalmente).

DDFXCAPS_OVERLAYARITHSTRETCHYN

Usa operazioni aritmetiche, anziché tecniche di raddoppio dei pixel, per estendere e compattare le superfici sovrapposte. Si verifica lungo l'asse y (verticalmente) e funziona solo per l'estensione integer (×1, ×2 e così via).

DDFXCAPS_OVERLAYFILTER

Supporta il filtro per la ricostruzione superficiale per gli sprite sovrapposti con distorsione. Il filtro non è attualmente supportato per le superfici sovrapposte visualizzate in modo esplicito (quelle visualizzate con chiamate a IDirectDrawSurface7::UpdateOverlay).

DDFXCAPS_OVERLAYMIRRORLEFTRIGHT

Supporta il mirroring delle sovrimpressioni sull'asse verticale.

DDFXCAPS_OVERLAYMIRRORUPDOWN

Supporta il mirroring delle sovrimpressioni sull'asse orizzontale.

DDFXCAPS_OVERLAYSHRINKX

Supporta la compattazione arbitraria di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che la compattazione è disponibile.

DDFXCAPS_OVERLAYSHRINKXN

Supporta la compattazione di numeri interi (×1, ×2 e così via) di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che la compattazione è disponibile.

DDFXCAPS_OVERLAYSHRINKY

Supporta la compattazione arbitraria di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che la compattazione è disponibile.

DDFXCAPS_OVERLAYSHRINKYN

Supporta la compattazione di numeri interi (×1, ×2 e così via) di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che la compattazione è disponibile.

DDFXCAPS_OVERLAYSTRETCHX

Supporta l'estensione arbitraria di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che l'estensione è disponibile.

DDFXCAPS_OVERLAYSTRETCHXN

Supporta l'estensione integer (×1, ×2 e così via) di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che l'estensione è disponibile.

DDFXCAPS_OVERLAYSTRETCHY

Supporta l'estensione arbitraria di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che l'estensione è disponibile.

DDFXCAPS_OVERLAYSTRETCHYN

Supporta l'estensione integer (×1, ×2 e così via) di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per DDSCAPS_OVERLAY superfici. Questo flag indica solo le funzionalità di una superficie; non indica che l'estensione è disponibile.

DDFXCAPS_OVERLAYTRANSFORM

Supporta trasformazioni geometriche (o distorsioni) per gli sprite sovrapposti. Le trasformazioni non sono attualmente supportate per le superfici sovrapposte visualizzate in modo esplicito (quelle visualizzate con chiamate a IDirectDrawSurface7::UpdateOverlay).

dwFXAlphaCaps

Questo valore è costituito da uno o più flag seguenti che specificano le funzionalità alfa del driver.

DDFXALPHACAPS_BLTALPHAEDGEBLEND

Supporta la fusione alfa attorno al bordo di una superficie con chiave a colori di origine. Usato per le operazioni bitblt.

DDFXALPHACAPS_BLTALPHAPIXELS

Supporta le informazioni alfa in formato pixel. La profondità di bit delle informazioni alfa nel formato pixel può essere 1, 2, 4 o 8. Il valore alfa diventa più opaco man mano che aumenta il valore alfa. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente trasparente. Usato per le operazioni bitblt.

DDFXALPHACAPS_BLTALPHAPIXELSNEG

Supporta le informazioni alfa in formato pixel. La profondità di bit delle informazioni alfa nel formato pixel può essere 1, 2, 4 o 8. Il valore alfa diventa più trasparente man mano che aumenta il valore alfa. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente opaco. Questo flag può essere usato solo se è impostato DDCAPS_ALPHA. Usato per le operazioni bitblt.

DDFXALPHACAPS_BLTALPHASURFACES

Supporta superfici alfa-only. La profondità di bit di una superficie alfa-only può essere 1, 2, 4 o 8. Il valore alfa diventa più opaco man mano che aumenta il valore alfa. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente trasparente. Usato per le operazioni bitblt.

DDFXALPHACAPS_BLTALPHASURFACESNEG

Indica che il canale alfa diventa più trasparente man mano che aumenta il valore alfa. La profondità dei dati del canale alfa può essere 1, 2, 4 o 8. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente opaco. Questo flag può essere impostato solo se è stato impostato DDCAPS_ALPHA. Usato per le operazioni bitblt.

DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND

Supporta la fusione alfa attorno al bordo di una superficie con chiave a colori di origine. Usato per le sovrimpressioni.

DDFXALPHACAPS_OVERLAYALPHAPIXELS

Supporta le informazioni alfa in formato pixel. La profondità di bit delle informazioni alfa in formato pixel può essere 1, 2, 4 o 8. Il valore alfa diventa più opaco man mano che aumenta il valore alfa. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente trasparente. Usato per le sovrimpressioni.

DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG

Supporta le informazioni alfa in formato pixel. La profondità di bit delle informazioni alfa in formato pixel può essere 1, 2, 4 o 8. Il valore alfa diventa più trasparente man mano che aumenta il valore alfa. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente opaco. Questo flag può essere usato solo se è stato impostato DDCAPS_ALPHA. Usato per le sovrimpressioni.

DDFXALPHACAPS_OVERLAYALPHASURFACES

Supporta superfici alfa-only. La profondità di bit di una superficie alfa-only può essere 1, 2, 4 o 8. Il valore alfa diventa più opaco man mano che aumenta il valore alfa. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente trasparente. Usato per le sovrimpressioni.

DDFXALPHACAPS_OVERLAYALPHASURFACESNEG

Indica che il canale alfa diventa più trasparente man mano che aumenta il valore alfa. La profondità dei dati del canale alfa può essere 1, 2, 4 o 8. Indipendentemente dalla profondità delle informazioni alfa, 0 è sempre il valore completamente opaco. Questo flag può essere usato solo se è stato impostato DDCAPS_ALPHA. Usato per le sovrimpressioni.

dwPalCaps

Questo valore è costituito da uno o più flag seguenti che specificano le funzionalità del riquadro.

DDPCAPS_1BIT

Supporta le tavolozze che contengono voci di colore a 1 bit (due colori).

DDPCAPS_2BIT

Supporta le tavolozze che contengono voci di colore a 2 bit (quattro colori).

DDPCAPS_4BIT

Supporta le tavolozze che contengono voci di colore a 4 bit (16 colori).

DDPCAPS_8BIT

Supporta le tavolozze che contengono voci di colore a 8 bit (256 colori).

DDPCAPS_8BITENTRIES

Specifica un indice di colore a 8 bit. Questo campo è valido solo se usato con la funzionalità DDPCAPS_1BIT, DDPCAPS_2BIT o DDPCAPS_4BIT e quando la superficie di destinazione è di 8 bit per pixel (bpp). Ogni voce di colore è lunga 1 byte ed è un indice di una tavolozza da 8 bpp sulla superficie di destinazione.

DDPCAPS_ALPHA

Supporta le tavolozze che includono un componente alfa. Per le tavolozze con supporto per alfa, il membro peFlags di ogni struttura PALETTEENTRY contenuta nella tavolozza deve essere interpretato come un singolo valore alfa a 8 bit (oltre ai dati di colore nei membri peRed, peGreen e peBlue ). Una tavolozza creata con questo flag può essere collegata solo a una superficie di trama.

DDPCAPS_ALLOW256

Supporta le tavolozze che possono avere tutte le 256 voci definite.

DDPCAPS_PRIMARYSURFACE

La tavolozza è collegata alla superficie primaria. La modifica della tavolozza ha un effetto immediato sullo schermo, a meno che non venga specificata e supportata la funzionalità di DDPCAPS_VSYNC.

DDPCAPS_PRIMARYSURFACELEFT

La tavolozza è collegata alla superficie primaria a sinistra. La modifica della tavolozza ha un effetto immediato sullo schermo, a meno che non venga specificata e supportata la funzionalità di DDPCAPS_VSYNC.

DDPCAPS_VSYNC

La tavolozza può essere modificata in modo sincrono con la frequenza di aggiornamento del monitor.

dwSVCaps

Questo valore è costituito da uno o più flag seguenti che specificano le funzionalità di visione stereo.

DDSVCAPS_RESERVED1, DDSVCAPS_RESERVED2, DDSVCAPS_RESERVED3, DDSVCAPS_RESERVED4

Flag riservati.

DDSVCAPS_STEREOSEQUENTIAL

Novità per DirectX 7.0. Il driver può eseguire stereo in almeno una modalità diversa dalla modalità corrente. L'applicazione può usare IDirectDraw7::GetDisplayMode o IDirectDraw7::EnumDisplayModes per ottenere informazioni stereo per modalità.

dwAlphaBltConstBitDepths

DDBD_2, DDBD_4 o DDBD_8. (Indicare 2, 4 o 8 bit per pixel).

dwAlphaBltPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 o DDBD_8. (Indicare 1, 2, 4 o 8 bit per pixel).

dwAlphaBltSurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 o DDBD_8. (Indicare 1, 2, 4 o 8 bit per pixel).

dwAlphaOverlayConstBitDepths

DDBD_2, DDBD_4 o DDBD_8. (Indicare 2, 4 o 8 bit per pixel).

dwAlphaOverlayPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 o DDBD_8. (Indicare 1, 2, 4 o 8 bit per pixel).

dwAlphaOverlaySurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 o DDBD_8. (Indicare 1, 2, 4 o 8 bit per pixel).

dwZBufferBitDepths

DDBD_8, DDBD_16, DDBD_24 o DDBD_32. (Indicare 8, 16, 24 o 32 bit per pixel). Questo membro è obsoleto per DirectX 6.0 e versioni successive. Usare IDirect3D7::EnumZBufferFormats per recuperare informazioni sui formati di buffer di profondità supportati.

dwVidMemTotal

Quantità totale di memoria visualizzata nel dispositivo, in byte, meno memoria riservata per la superficie primaria ed eventuali strutture di dati private riservate dal driver. Questo valore corrisponde alla memoria video totale segnalata dal metodo IDirectDraw7::GetAvailableVidMem .

dwVidMemFree

Memoria di visualizzazione libera. Questo valore è uguale al valore in dwVidMemTotal, meno qualsiasi memoria attualmente allocata dall'applicazione per le superfici. A differenza del metodo IDirectDraw7::GetAvailableVidMem , che segnala la memoria disponibile per un particolare tipo di superficie (ad esempio una trama), questo valore riflette la memoria disponibile per qualsiasi tipo di superficie.

dwMaxVisibleOverlays

Numero massimo di sovrimpressioni visibili o sprite sovrapposte.

dwCurrVisibleOverlays

Numero corrente di sovrimpressioni visibili o sprite sovrapposti.

dwNumFourCCCodes

Numero di codici FourCC.

dwAlignBoundarySrc

Allineamento del rettangolo di origine per una superficie di sovrapposizione, in pixel.

dwAlignSizeSrc

Allineamento delle dimensioni del rettangolo di origine per una superficie di sovrapposizione, in pixel. I rettangoli di origine di sovrapposizione devono avere una larghezza in pixel che è un multiplo di questo valore.

dwAlignBoundaryDest

Allineamento rettangolo di destinazione per una superficie di sovrapposizione, in pixel.

dwAlignSizeDest

Allineamento delle dimensioni del rettangolo di destinazione per una superficie di sovrapposizione, in pixel. I rettangoli di destinazione di sovrapposizione devono avere una larghezza in pixel che è un multiplo di questo valore.

dwAlignStrideAlign

Allineamento dello stride.

dwRops[DD_ROP_SPACE]

Operazioni raster supportate.

ddsCaps

Struttura DDSCAPS2 che contiene funzionalità di superficie generali.

dwMinOverlayStretch

Fattore di estensione della sovrimpressione minimo, moltiplicato per 1000. Ad esempio, 1,3 = 1300.

dwMaxOverlayStretch

Fattore di estensione della sovrimpressione massimo moltiplicato per 1000. Ad esempio, 1,3 = 1300.

dwMinLiveVideoStretch

Obsoleto; non usare.

dwMaxLiveVideoStretch

Obsoleto; non usare.

dwMinHwCodecStretch

Obsoleto; non usare.

dwMaxHwCodecStretch

Obsoleto; non usare.

dwReserved1

Riservato

dwReserved2

Riservato

dwReserved3

Riservato

dwSVBCaps

Funzionalità specifiche del driver per i bitblts dalla memoria di sistema per visualizzare la memoria. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwCaps .

dwSVBCKeyCaps

Funzionalità chiave del driver per bitblts dalla memoria di sistema per visualizzare la memoria. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwCKeyCaps .

dwSVBFXCaps

Funzionalità fx del driver per bitblts dalla memoria di sistema per visualizzare la memoria. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwFXCaps .

dwSVBRops[DD_ROP_SPACE]

Operazioni raster supportate per i bitblts dalla memoria di sistema per visualizzare la memoria.

dwVSBCaps

Funzionalità specifiche del driver per bitblts dalla memoria di visualizzazione alla memoria di sistema. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwCaps .

dwVSBCKeyCaps

Funzionalità chiave del driver per i bitblts dalla memoria di visualizzazione alla memoria di sistema. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwCKeyCaps .

dwVSBFXCaps

Funzionalità fx del driver per i bitblts dalla memoria di visualizzazione alla memoria di sistema. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwFXCaps .

dwVSBRops[DD_ROP_SPACE]

Operazioni raster supportate per i bitblts dalla memoria di visualizzazione alla memoria di sistema.

dwSSBCaps

Funzionalità specifiche del driver per bitblts dalla memoria di sistema alla memoria di sistema. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwCaps .

dwSSBCKeyCaps

Funzionalità chiave del driver per i bitblts dalla memoria di sistema alla memoria di sistema. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwCKeyCaps .

dwSSBFXCaps

Funzionalità fx del driver per bitblts dalla memoria di sistema alla memoria di sistema. I flag validi sono identici ai flag correlati a bitblt usati con il membro dwFXCaps .

dwSSBRops[DD_ROP_SPACE]

Operazioni raster supportate per i bitblts dalla memoria di sistema alla memoria di sistema.

dwReserved4

Riservato

dwReserved5

Riservato

dwReserved6

Riservato

Commenti

Per la compatibilità con le versioni precedenti, il file di intestazione Ddraw.h contiene più definizioni della struttura DDCAPS. La versione che passa il preprocessore è determinata dal valore della costante DIRECTDRAW_VERSION.

Requisiti

Intestazione	ddraw.h