Struttura DDCORECAPS (ddrawi.h)

La struttura DDCORECAPS specifica le funzionalità principali del driver Microsoft DirectDraw e del relativo dispositivo, esposte a un'applicazione tramite l'oggetto DirectDraw.

Sintassi

typedef struct _DDCORECAPS {
  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   dwMaxVideoPorts;
  DWORD   dwCurrVideoPorts;
  DWORD   dwSVBCaps2;
} DDCORECAPS;

Members

dwSize

Specifica le dimensioni in byte di questa struttura DDCORECAPS.

dwCaps

Indica un flag che specifica le funzionalità del driver. Il driver deve impostare il bit DDCAPS_Xxx appropriato per ogni funzionalità supportata.

Contrassegno Significato
DDCAPS_3D L'hardware dello schermo ha accelerazione 3D.
DDCAPS_ALIGNBOUNDARYDEST DirectDraw supporta solo i rettangoli di origine con l'asse x allineato ai limiti dwAlignBoundaryDest della superficie.
DDCAPS_ALIGNBOUNDARYSRC DirectDraw supporta solo i rettangoli di origine con l'asse x allineato ai limiti dwAlignBoundarySrc della superficie.
DDCAPS_ALIGNSIZEDEST DirectDraw supporta solo i rettangoli di origine le cui dimensioni dell'asse x, in byte, sono multipli dwAlignSizeDest .
DDCAPS_ALIGNSIZESRC DirectDraw supporta solo i rettangoli di origine le cui dimensioni dell'asse x, in byte, sono multiple 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 un canale alfa durante le operazioni blit.
DDCAPS_BANKSWITCHED L'hardware dello schermo è commutato in banca ed è potenzialmente molto lento ad accesso casuale per visualizzare la memoria. Se questo bit di funzionalità viene impostato dal driver Microsoft Windows 2000 o versione successiva, DirectDraw è disabilitato.
DDCAPS_BLT L'hardware di visualizzazione è in grado di eseguire operazioni blit.
DDCAPS_BLTCOLORFILL L'hardware dello schermo è in grado di riempire di colori con un blitter.
DDCAPS_BLTDEPTHFILL L'hardware dello schermo è in grado di riempire i buffer z con un blitter.
DDCAPS_BLTFOURCC L'hardware dello schermo è in grado di eseguire conversioni dello spazio dei colori durante le operazioni di blit.
DDCAPS_BLTQUEUE L'hardware di visualizzazione è in grado di eseguire operazioni blit asincrone.
DDCAPS_BLTSTRETCH L'hardware di visualizzazione è in grado di estendersi durante le operazioni di blit.
DDCAPS_CANBLTSYSMEM L'hardware di visualizzazione è in grado di eseguire il blitting a o dalla memoria di sistema.
DDCAPS_CANCLIP L'hardware dello schermo è in grado di ritagliare con blitting.
DDCAPS_CANCLIPSTRETCHED L'hardware dello schermo è in grado di ritagliare durante l'estensione-blitting.
DDCAPS_COLORKEY È supportata una forma di chiave di colore nelle operazioni di sovrapposizione o blit. Nel membro dwCKeyCaps sono disponibili informazioni più specifiche sulle funzionalità della chiave del colore.
DDCAPS_COLORKEYHWASSIST La chiave di colore è assistita dall'hardware.
DDCAPS_GDI L'hardware di visualizzazione viene condiviso con GDI. Se questo bit di funzionalità è impostato dal driver Windows 2000 o versione successiva, DirectDraw è disabilitato.
DDCAPS_NOHARDWARE Non esiste alcun supporto hardware.
DDCAPS_OVERLAY L'hardware di visualizzazione supporta le sovrimpressioni.
DDCAPS_OVERLAYCANTCLIP L'hardware di visualizzazione supporta sovrimpressioni, ma non può ritagliarle.
DDCAPS_OVERLAYFOURCC L'hardware di sovrapposizione è in grado di eseguire conversioni dello spazio dei colori durante le operazioni di sovrimpressione.
DDCAPS_OVERLAYSTRETCH L'hardware di sovrimpressione è in grado di estendersi.
DDCAPS_PALETTE DirectDraw è in grado di creare e supportare oggetti DirectDrawPalette per più della sola superficie primaria. Se questo bit di funzionalità è impostato dal driver Windows 2000 o versione successiva, DirectDraw è disabilitato.
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_STEREOVIEW L'hardware dello schermo ha funzionalità di visione stereo.
DDCAPS_VBI L'hardware di visualizzazione è in grado di generare un interrupt verticale vuoto.
DDCAPS_ZBLTS Supporta l'uso di buffer z con operazioni blit.
DDCAPS_ZOVERLAYS Supporta l'uso del metodo UpdateOverlayZOrder dell'applicazione come valore z per le sovrimpressioni per controllare il livello. Se questo bit di funzionalità è impostato dal driver Windows 2000 o versione successiva, DirectDraw è disabilitato.

dwCaps2

Specificare altre funzionalità del driver. Il driver deve impostare il bit DDCAPS2_Xxx appropriato per ogni funzionalità supportata.

Contrassegno Significato
DDCAPS2_AUTOFLIPOVERLAY La sovrimpressione può essere capovolta automaticamente alla superficie successiva nella catena di capovolgimento ogni volta che si verifica una sincronizzazione V-porta video hardware, consentendo l'oggetto VPE (Video Port Extensions) e la sovrimpressione per raddoppiare il buffer del video senza sovraccarico della CPU. Questa opzione è valida solo quando la superficie riceve dati dalla porta video hardware. Se i dati della porta video hardware sono non interlacciati o noninterlacciati, viene capovolto in ogni sincronizzazione V. Se i dati vengono interleavedi in memoria, si capovolge ogni altra sincronizzazione V.
DDCAPS2_CANAUTOGENMIPMAP
Solo DirectX 9.0 e versioni successive.
Il driver e il relativo dispositivo supportano la rigenerazione automatica dei sublevel delle trame mipmap.
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 un oggetto VPE ed è valida solo quando il video viene ingrandita almeno il 200% 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 un oggetto VPE ed è valida solo quando il video viene ingrandita almeno il 200% nella direzione verticale.
DDCAPS2_CANCALIBRATEGAMMA Un calibratore è disponibile per regolare la rampa gamma in base alle proprietà di visualizzazione fisiche in modo che il risultato sia identico a tutti i sistemi calibrati.
DDCAPS2_CANDROPZ16BIT I valori RGBZ a 16 bit possono essere convertiti in valori RGB a 16 bit. Il sistema non supporta conversioni a otto bit.
DDCAPS2_CANFLIPODDEVEN Il driver supporta bob usando software senza usare un oggetto VPE.
DDCAPS2_CANMANAGERESOURCE Il driver supporta la gestione delle risorse.
DDCAPS2_CANMANAGETEXTURE Il driver supporta la gestione delle trame.
DDCAPS2_CANRENDERWINDOWED Il driver può eseguire il rendering in modalità finestra.
DDCAPS2_CERTIFIED L'hardware di visualizzazione è certificato.
DDCAPS2_COLORCONTROLOVERLAY La superficie di sovrapposizione contiene controlli colore (luminosità, nitidezza e così via).
DDCAPS2_COLORCONTROLPRIMARY La superficie primaria contiene controlli colore (gamma e così via).
DDCAPS2_COPYFOURCC Il driver supporta il blitting a qualsiasi superficie FOURCC in un'altra superficie dello stesso FOURCC .
DDCAPS2_FLIPINTERVAL Il driver risponde ai flag di DDFLIP_INTERVAL2, DDFLIP_INTERVAL3 e DDFLIP_INTERVAL4.
DDCAPS2_FLIPNOVSYNC Il driver risponde alle DDFLIP_FLIPNOVSYNC.
DDCAPS2_NO2DDURING3DSCENE Il driver non può interleare operazioni 2D, ad esempio DdBlt o DdLock su qualsiasi superficie che Microsoft Direct3D usa tra le chiamate ai metodi IDirect3DDevice::BeginScene e IDirect3DDevice::EndScene.
DDCAPS2_NONLOCALVIDMEM Il driver supporta memoria di visualizzazione non locale.
DDCAPS2_NONLOCALVIDMEMCAPS Le funzionalità Blit per le superfici di memoria di visualizzazione non locali differiscono dalle superfici di memoria di visualizzazione locale. Se questo flag è presente, è presente anche il flag DDCAPS2_NONLOCALVIDMEM.
DDCAPS2_NOPAGELOCKREQUIRED Il driver deve essere chiamato per i blit che coinvolgono superfici di memoria di sistema anche se le superfici di memoria di sistema non sono in blocco.
DDCAPS2_PRIMARYGAMMA Il driver supporta rampe gamma caricabili per la superficie primaria.
DDCAPS2_VIDEOPORT L'hardware di visualizzazione contiene una porta video hardware.
DDCAPS2_WIDESURFACES Il driver di visualizzazione può creare superfici più ampie della superficie primaria. I driver che impostano questo bit devono ricevere richieste CreateSurface dalle applicazioni per superfici più ampie rispetto alla superficie primaria.

dwCKeyCaps

Specificare le funzionalità della chiave di colore delle superfici. Il driver deve impostare il bit DDCKEYCAPS_Xxx appropriato per ogni funzionalità supportata.

Contrassegno Significato
DDCKEYCAPS_DESTBLT Supporta blitting trasparente con una chiave di colore che identifica i bit sostituibili dell'area di destinazione per i colori RGB.
DDCKEYCAPS_DESTBLTCLRSPACE Supporta blitting trasparente con uno spazio colore che identifica i bit sostituibili della superficie di destinazione per i colori RGB.
DDCKEYCAPS_DESTBLTCLRSPACEYUV Supporta blitting trasparente con uno spazio colore che identifica i bit sostituibili della superficie di destinazione per i colori YUV.
DDCKEYCAPS_DESTBLTYUV Supporta 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 chiave di colore dei bit sostituibili della superficie di destinazione sovrapponibile 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 di colore di destinazione attiva per le superfici di sovrapposizione visibili.
DDCKEYCAPS_DESTOVERLAYYUV Supporta la sovrapposizione usando la chiave di colore dei bit sostituibili della superficie di destinazione sovrapponibile per i colori YUV.
DDCKEYCAPS_NOCOSTOVERLAY Indica che non sono presenti compromessi di larghezza di banda per l'uso della chiave di colore con una sovrapposizione.
DDCKEYCAPS_SRCBLT Supporta blitting trasparente usando la chiave di colore per l'origine con questa superficie per i colori RGB.
DDCKEYCAPS_SRCBLTCLRSPACE Supporta blitting trasparente usando uno spazio colore per l'origine con questa superficie per i colori RGB.
DDCKEYCAPS_SRCBLTCLRSPACEYUV Supporta blitting trasparente usando uno spazio colore per l'origine con questa superficie per i colori YUV.
DDCKEYCAPS_SRCBLTYUV Supporta 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 sovrapposizione usando uno spazio colore come chiave 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 di 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

Specificare le funzionalità di estensione e effetti del driver. Il driver deve impostare il bit DDFXCAPS_Xxx appropriato per ogni funzionalità supportata.

Contrassegno Significato
DDFXCAPS_BLTARITHSTRETCHY Usa operazioni aritmetiche, anziché tecniche di raddoppio dei pixel, per estendere e compattare le superfici durante un'operazione blit. 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 blit. Si verifica lungo l'asse y (verticalmente) e funziona solo per l'estensione integer (x1, x2 e così via).
DDFXCAPS_BLTMIRRORLEFTRIGHT Supporta il mirroring a sinistra a destra in un'operazione blit.
DDFXCAPS_BLTMIRRORUPDOWN Supporta il mirroring superiore in basso in un'operazione blit.
DDFXCAPS_BLTROTATION Supporta la rotazione arbitraria in un'operazione blit. Se questo bit di funzionalità è impostato dal driver Windows 2000 o versione successiva, DirectDraw è disabilitato.
DDFXCAPS_BLTROTATION90 Supporta le rotazioni a 90 gradi in un'operazione blit. Se questo bit di funzionalità è impostato dal driver Windows 2000 o versione successiva, DirectDraw è disabilitato.
DDFXCAPS_BLTSHRINKX Supporta la compattazione arbitraria di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_BLTSHRINKXN Supporta la compattazione di numeri interi (x1, x2 e così via) di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_BLTSHRINKY Supporta la compattazione arbitraria di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_BLTSHRINKYN Supporta la compattazione di numeri interi (x1, x2 e così via) di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_BLTSTRETCHX Supporta l'estensione arbitraria di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_BLTSTRETCHXN Supporta l'estensione integer (x1, x2 e così via) di una superficie lungo l'asse x (orizzontalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_BLTSTRETCHY Supporta l'estensione arbitraria di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_BLTSTRETCHYN Supporta l'estensione integer (x1, x2 e così via) di una superficie lungo l'asse y (verticalmente). Questo flag è valido solo per le operazioni blit.
DDFXCAPS_OVERLAYARITHSTRETCHY Usa operazioni aritmetiche, anziché tecniche di raddoppio dei pixel, per estendere e compattare le superfici durante un'operazione di sovrapposizione. Si verifica lungo l'asse y (verticalmente).
DDFXCAPS_OVERLAYARITHSTRETCHYN Usa operazioni aritmetiche, anziché tecniche di raddoppio dei pixel, per estendere e compattare le superfici durante un'operazione di sovrapposizione. Si verifica lungo l'asse y (verticalmente) e funziona solo per l'estensione integer (x1, x2 e così via).
DDFXCAPS_OVERLAYMIRRORLEFTRIGHT Supporta il mirroring delle sovrimpressioni attorno all'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 (x1, x2 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 (x1, x2 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 (x1, x2 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 (x1, x2 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.

dwFXAlphaCaps

Questo membro e i relativi flag sono obsoleti e non devono essere usati dal driver.

dwPalCaps

Specificare le funzionalità della tavolozza del driver. Il driver deve impostare il bit DDPCAPS_Xxx appropriato per ogni funzionalità supportata. I flag DDPCAPS_Xxx sono definiti in ddraw.h. Il runtime directDraw ignora attualmente queste funzionalità.

dwSVCaps

Specificare le funzionalità di visione stereo del driver. Il driver deve impostare il bit DDSVCAPS_Xxx appropriato per ogni funzionalità supportata.

Contrassegno Significato
DDSVCAPS_ENIGMA La visualizzazione stereo viene eseguita usando la codifica Puzzle.
DDSVCAPS_FLICKER La visualizzazione stereo viene eseguita usando sfarfallio ad alta frequenza.
DDSVCAPS_REDBLUE La visualizzazione stereo viene eseguita quando il visualizzatore guarda l'immagine attraverso filtri rossi e blu posizionati sugli occhi sinistro e destro. Tutte le immagini devono adattare i propri spazi di colore per questo processo.
DDSVCAPS_SPLIT La visualizzazione stereo viene eseguita con la tecnologia a schermo diviso.

dwAlphaBltConstBitDepths

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwAlphaBltPixelBitDepths

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwAlphaBltSurfaceBitDepths

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwAlphaOverlayConstBitDepths

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwAlphaOverlayPixelBitDepths

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwAlphaOverlaySurfaceBitDepths

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwZBufferBitDepths

Indica un flag che specifica le profondità del buffer Z supportate dal driver. Può trattarsi di uno o più dei valori seguenti:

Contrassegno Significato
DDBD_8 Il driver supporta un buffer di profondità di 8bpp.
DDBD_16 Il driver supporta un buffer di profondità di 16bpp.
DDBD_24 Il driver supporta un buffer di profondità 24bpp.
DDBD_32 Il driver supporta un buffer di profondità 32bpp.

dwVidMemTotal

Specifica la quantità totale di memoria visualizzata, espressa in byte.

dwVidMemFree

Specifica il numero di byte di memoria di visualizzazione libera. Il driver imposta questo membro una volta durante l'inizializzazione sullo stesso valore restituito nel membro dwVidMemTotal . DirectDraw lo aggiorna ogni volta che l'applicazione esegue un'allocazione di memoria.

dwMaxVisibleOverlays

Specifica il numero massimo di sovrimpressioni visibili.

dwCurrVisibleOverlays

Specifica il numero corrente di sovrimpressioni visibili.

dwNumFourCCCodes

Specifica il numero di codici FOURCC supportati dal driver.

dwAlignBoundarySrc

Specifica l'allineamento del rettangolo di origine. Questo membro può essere impostato facoltativamente dal driver. Se il driver imposta questo membro, il valore della coordinata superiore sinistra del rettangolo di origine di sovrapposizione deve essere un multiplo di dwAlignBoundarySrc.

dwAlignSizeSrc

Specifica le dimensioni del rettangolo di origine, in byte. Questo membro può essere impostato facoltativamente dal driver. Se il driver imposta questo membro, la larghezza del rettangolo di origine di sovrapposizione deve essere un multiplo di dwAlignSizeSrc.

dwAlignBoundaryDest

Specifica l'allineamento del rettangolo di destinazione. Questo membro può essere impostato facoltativamente dal driver. Se il driver imposta questo membro, il valore della coordinata superiore sinistra del rettangolo di destinazione di sovrapposizione deve essere un multiplo di dwAlignBoundaryDest.

dwAlignSizeDest

Specifica le dimensioni del byte del rettangolo di destinazione. Questo membro può essere impostato facoltativamente dal driver. Se il driver imposta questo membro, la larghezza del rettangolo di destinazione di sovrapposizione deve essere un multiplo di dwAlignSizeDest.

dwAlignStrideAlign

Riservato per l'uso del sistema e deve essere ignorato dal driver.

dwRops[DD_ROP_SPACE]

Specifica una matrice di DD_ROP_SPACE DWORD che insieme possono contenere flag per indicare gli indirizzi ROP supportati dal driver. Il driver deve impostare il campo di bit per ogni ROP corrispondente supportato. Vedere la documentazione di Microsoft Windows SDK per informazioni sugli indirizzi ROP.

ddsCaps

Specifica una struttura DDSCAPS che descrive i tipi di superfici supportate dal driver.

dwMinOverlayStretch

Specifica il fattore di estensione di sovrimpressione minimo moltiplicato per 1000. Ad esempio, un fattore pari a 1,3 deve essere archiviato come 1300. Il driver di visualizzazione deve impostare il fattore minimo sul valore minimo effettivo in cui l'hardware grafico può ridurre la sovrimpressione. Se l'hardware grafico non presenta alcuna limitazione minima, impostare su 1.

dwMaxOverlayStretch

Specifica il fattore di estensione di sovrimpressione massimo moltiplicato per 1000. Ad esempio, un fattore pari a 1,3 deve essere archiviato come 1300. Il driver di visualizzazione deve impostare il fattore massimo sul valore massimo effettivo a cui l'hardware grafico può estendere la sovrimpressione. Se l'hardware grafico non ha limiti massimi, impostare su 32000.

dwMinLiveVideoStretch

Specifica il fattore minimo di estensione video live moltiplicato per 1000. Ad esempio, un fattore pari a 1,3 deve essere archiviato come 1300.

dwMaxLiveVideoStretch

Specifica il fattore di estensione video live massimo moltiplicato per 1000. Ad esempio, un fattore pari a 1,3 deve essere archiviato come 1300.

dwMinHwCodecStretch

Specifica il fattore di estensione del codec hardware minimo moltiplicato per 1000. Ad esempio, un fattore pari a 1,3 deve essere archiviato come 1300.

dwMaxHwCodecStretch

Specifica il fattore di estensione del codec hardware massimo moltiplicato per 1000. Ad esempio, un fattore pari a 1,3 deve essere archiviato come 1300.

dwReserved1

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwReserved2

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwReserved3

Riservato per l'utilizzo nel sistema. Il driver deve ignorare questo membro.

dwSVBCaps

Indica un set di flag che specificano le funzionalità specifiche del driver per i blit di memoria da sistema a schermo. Il driver deve essere bit per bit OPPURE i flag DDCAPS_Xxx appropriati (vedere il membro dwCaps ) per indicare i tipi di operazioni blit supportate quando si esegue il blitting dalla memoria di sistema per visualizzare la memoria.

dwSVBCKeyCaps

Indica un set di flag che specificano le funzionalità della chiave a colori del driver per i blit di memoria da sistema a schermo. Il driver deve essere bit per bit OPPURE i flag DDCKEYCAPS_Xxx appropriati (vedere il membro dwCKeyCaps ) per indicare i tipi di operazioni chiave colore supportate durante il blitting dalla memoria di sistema per visualizzare la memoria.

dwSVBFXCaps

Indica un set di flag che specificano le funzionalità fx del driver per i blit di memoria da sistema a schermo. Il driver deve essere bit per bit OR i flag DDFXCAPS_Xxx appropriati (vedere il membro dwFXCaps ) per indicare i tipi di effetti supportati quando si esegue il blitting dalla memoria di sistema per visualizzare la memoria.

dwSVBRops[DD_ROP_SPACE]

Specifica una matrice di DWORD di DD_ROP_SPACE che insieme possono contenere flag per indicare i punti di aggiornamento supportati dal driver durante l'esecuzione di blit da memoria di sistema a visualizzazione. Il driver deve impostare il campo di bit per ogni ROP corrispondente supportato. Vedere la documentazione di Microsoft Windows SDK per informazioni sugli indirizzi ROP.

dwVSBCaps

Indica un set di flag che specificano funzionalità specifiche del driver per i blit display-memory-to-system-memory. Il driver deve essere bit per bit OR i flag DDCAPS_Xxx appropriati (vedere il membro dwCaps ) per indicare i tipi di operazioni blit supportate quando si esegue il blitting dalla memoria di visualizzazione alla memoria di sistema.

dwVSBCKeyCaps

Indica un set di flag che specificano le funzionalità della chiave del colore del driver per i blit display-memory-to-system-memory. Il driver deve essere bit per bit OPPURE i flag DDCKEYCAPS_Xxx appropriati (vedere il membro dwCKeyCaps ) per indicare i tipi di operazioni chiave colore supportate quando si esegue il blitting dalla memoria di visualizzazione alla memoria di sistema.

dwVSBFXCaps

Indica un set di flag che specificano le funzionalità fx del driver per i blit display-memory-to-system-memory. Il driver deve essere bit per bit OR i flag DDFXCAPS_Xxx appropriati (vedere il membro dwFXCaps ) per indicare i tipi di effetti supportati quando si esegue il blitting dalla memoria di visualizzazione alla memoria di sistema.

dwVSBRops[DD_ROP_SPACE]

Specifica una matrice di DWORD di DD_ROP_SPACE che insieme possono contenere flag per indicare i punti di aggiornamento supportati dal driver durante l'esecuzione di blit da display-memory-to-system. Il driver deve impostare il campo di bit per ogni ROP corrispondente supportato. Vedere la documentazione di Windows SDK per informazioni sui provider di servizi di aggiornamento.

dwSSBCaps

Indica un set di flag che specificano funzionalità specifiche del driver per i blit di memoria da sistema a sistema. Il driver deve essere bit per bit OPPURE i flag DDCAPS_Xxx appropriati (vedere il membro dwCaps ) per indicare i tipi di operazioni blit supportate quando si esegue il blitting dalla memoria di sistema alla memoria di sistema.

dwSSBCKeyCaps

Indica un set di flag che specificano le funzionalità della chiave a colori del driver per i blit da sistema a memoria di sistema. Il driver deve essere bit per bit OPPURE i flag DDCKEYCAPS_Xxx appropriati (vedere il membro dwCKeyCaps ) per indicare i tipi di operazioni chiave colore supportate quando si esegue il blitting dalla memoria di sistema alla memoria di sistema.

dwSSBFXCaps

Indica un set di flag che specificano le funzionalità fx del driver per i blit di memoria da sistema a sistema. Il driver deve essere or bit per bit i flag DDFXCAPS_Xxx appropriati (vedere il membro dwFXCaps ) per indicare i tipi di effetti supportati durante il blitting dalla memoria di sistema alla memoria di sistema.

dwSSBRops[DD_ROP_SPACE]

Specifica una matrice di DWORD di DD_ROP_SPACE che insieme può contenere flag per indicare gli indirizzi ROP supportati dal driver durante l'esecuzione di blit da memoria di sistema a sistema. Il driver deve impostare il campo di bit per ogni ROP corrispondente supportato. Vedere la documentazione di Windows SDK per informazioni sui provider di servizi di aggiornamento.

dwMaxVideoPorts

Specifica il numero massimo di oggetti VPE utilizzabili.

dwCurrVideoPorts

Specifica il numero corrente di oggetti VPE utilizzati. Il driver non deve compilare questo membro perché è impostato da DirectDraw.

dwSVBCaps2

Specifica funzionalità aggiuntive specifiche del driver per i blit da sistema a memoria da sistema a schermo. I flag validi sono identici ai flag correlati a blit usati con il membro dwCaps2 .

Commenti

Questa sezione contiene la struttura del driver DirectDraw il cui nome ha il formato DDCORECAPS, che è il modulo usato in Windows 98/Me. Questa struttura è identica a quella il cui nome ha il formato DDNTCORECAPS, che è il modulo usato in Windows 2000 e versioni successive. Il file di inclusione dx95type.h contiene un tipo definito da DDNTCORECAPS a DDCORECAPS.

Questa struttura rispecchia le prime voci della struttura DDCAPS, ma è di dimensioni fisse e non aumenta man mano che DDCAPS.

Il driver inizializza DDCORECAPS quando inizializza gli altri membri della struttura DD_HALINFO nella struttura DrvGetDirectDrawInfo . Il runtime di DirectDraw potrebbe aggiornare alcuni membri.

DirectDraw richiede funzionalità aggiuntive del driver chiamando la funzione DdGetDriverInfo restituita anche nella struttura DD_HALINFO.

Requisiti

Requisito Valore
Intestazione ddrawi.h (include Ddrawi.h)