Struttura DDSCAPS (ddraw.h)
La struttura DDSCAPS definisce le funzionalità di un oggetto surface Microsoft DirectDraw.
Sintassi
typedef struct _DDSCAPS {
DWORD dwCaps;
} DDSCAPS;
Members
dwCaps
Indica un set di flag che specificano le funzionalità della superficie. Questo membro è un OR bit per bit di uno dei flag seguenti:
Contrassegno | Significato |
---|---|
DDSCAPS_3DDEVICE |
Questa superficie può essere usata per il rendering 3D. Le applicazioni possono usare questo flag per garantire che un dispositivo che possa essere eseguito solo il rendering in un determinato heap ha superfici offscreen allocate dall'heap corretto. Se questo flag è impostato per un heap, la superficie non viene allocata da tale heap. |
DDSCAPS_ALLOCONLOAD |
La memoria per la superficie non viene allocata finché la superficie non viene caricata dall'applicazione usando il metodo IDirect3DTexture::Load . |
DDSCAPS_ALPHA |
Questa superficie contiene solo informazioni alfa. |
DDSCAPS_BACKBUFFER |
Questa superficie è il buffer posteriore di una struttura di scorrimento della superficie. In genere, questa funzionalità viene impostata dal metodo CreateSurface dell'applicazione quando viene usato il flag di DDSCAPS_FLIP. Solo la superficie che precede immediatamente la superficie DDSCAPS_FRONTBUFFER ha questa funzionalità impostata. Le altre superfici vengono identificate come buffer indietro in base alla presenza del flag di DDSCAPS_FLIP, all'ordine di allegato e all'assenza delle funzionalità di DDSCAPS_FRONTBUFFER e DDSCAPS_BACKBUFFER. Se questa funzionalità viene inviata al metodo CreateSurface dell'applicazione, viene creato un buffer back autonomo. Dopo aver chiamato questo metodo, questa superficie potrebbe essere associata a un buffer anteriore, un altro buffer indietro o entrambi per formare una struttura di superficie di scorrimento. Per altre informazioni, vedere il metodo AddAttachedSurface in DirectX SDK. DirectDraw supporta un numero arbitrario di superfici in una struttura di scorrimento. |
DDSCAPS_COMPLEX |
Viene descritta una superficie complessa. Una superficie complessa comporta la creazione di più di una superficie. Le superfici aggiuntive sono associate alla superficie radice. La struttura complessa può essere distrutta solo distruggendo la radice. |
DDSCAPS_EXECUTEBUFFER |
La superficie è un buffer di esecuzione, ovvero un blocco lineare di memoria video o di sistema che contiene un elenco di visualizzazione di Microsoft Direct3D. Un driver segnala questo bit di funzionalità per indicare che può creare buffer di esecuzione in memoria video. Se il runtime Direct3D rileva questo bit, può richiedere buffer eseguiti dal driver. Le applicazioni non possono rilevare questo bit di funzionalità. |
DDSCAPS_FLIP |
Questa superficie fa parte di una struttura di scorrimento della superficie. Quando questa funzionalità viene passata al metodo CreateSurface dell'applicazione, viene creato un buffer anteriore e uno o più buffer back. DirectDraw imposta il bit di DDSCAPS_FRONTBUFFER sulla superficie del buffer anteriore e il bit di DDSCAPS_BACKBUFFER sulla superficie adiacente alla superficie del buffer anteriore. Il membro dwBackBufferCount della struttura DDSURFACEDESC deve essere impostato su almeno 1 affinché la chiamata al metodo abbia esito positivo. La funzionalità DDSCAPS_COMPLEX deve essere sempre impostata quando si creano più superfici usando il metodo CreateSurface . |
DDSCAPS_FRONTBUFFER |
Questa superficie è il buffer anteriore di una struttura di scorrimento della superficie. Questo flag viene in genere impostato dal metodo CreateSurface dell'applicazione quando viene impostata la funzionalità DDSCAPS_FLIP. Se questa funzionalità viene inviata al metodo CreateSurface , viene creato un buffer front autonomo. Questa superficie non ha la funzionalità di DDSCAPS_FLIP. Può essere collegato ad altri buffer indietro per formare una struttura di scorrimento usando il metodo AddAttachedSurface dell'applicazione. |
DDSCAPS_HWCODEC |
Questa superficie deve essere in grado di avere un flusso decompresso dall'hardware. |
DDSCAPS_LIVEVIDEO |
Questa superficie deve essere in grado di ricevere video live. |
DDSCAPS_LOCALVIDMEM |
Questa superficie esiste in true, la memoria di visualizzazione locale anziché la memoria di visualizzazione non locale. Se questo flag è specificato, è necessario specificare anche DDSCAPS_VIDEOMEMORY. Questo flag non può essere usato con il flag DDSCAPS_NONLOCALVIDMEM. |
DDSCAPS_MIPMAP |
Questa superficie è un livello di mipmap. Questa superficie è collegata ad altre superfici DDSCAPS_MIPMAP per formare la mipmap. Questa operazione può essere eseguita in modo esplicito creando un numero di superfici e associandole usando il metodo AddAttachedSurface dell'applicazione o implicitamente dal metodo CreateSurface dell'applicazione. Se questa funzionalità è impostata, è necessario impostare anche DDSCAPS_TEXTURE. |
DDSCAPS_MODEX |
Questa superficie è una superficie x 320x200 o 320x240 modalità X. Se questo bit di funzionalità è impostato dal driver Microsoft Windows 2000 o versione successiva, DirectDraw è disabilitato. |
DDSCAPS_NONLOCALVIDMEM |
Questa superficie esiste nella memoria di visualizzazione non locale anziché in true, la memoria di visualizzazione locale. Se questo flag è specificato, è necessario specificare anche DDSCAPS_VIDEOMEMORY flag. Impossibile usare questo oggetto con il flag di DDSCAPS_LOCALVIDMEM. |
DDSCAPS_OFFSCREENPLAIN |
Questa superficie è qualsiasi superficie offscreen che non è una superficie sovrapposta, trama, z-buffer, buffer front-buffer, back-buffer o superficie alfa. Viene usato per identificare le superfici semplici. |
DDSCAPS_OVERLAY |
Questa superficie è una sovrapposizione. La visibilità di questa sovrapposizione dipende dal fatto che sia attualmente sovralicciato sulla superficie primaria. DDSCAPS_VISIBLE può essere usato per determinare se è in corso l'overlaid al momento. |
DDSCAPS_OPTIMIZED |
Questo flag non è attualmente implementato. |
DDSCAPS_OWNDC |
Questa superficie avrà un'associazione del contesto del dispositivo (DC) per un periodo lungo. Se questa funzionalità è impostata dal driver Windows 2000 o versione successiva, DirectDraw verrà disabilitata. |
DDSCAPS_PALETTE |
Questo driver di dispositivo consente di creare oggetti DirectDrawPalette univoci e collegati a questa superficie. |
DDSCAPS_PRIMARYSURFACE |
Questa superficie è la superficie primaria. Rappresenta ciò che è visibile all'utente al momento. |
DDSCAPS_PRIMARYSURFACELEFT |
Questa superficie è la superficie primaria per l'occhio sinistro. Rappresenta ciò che è visibile all'occhio sinistro dell'utente al momento. Quando questa superficie viene creata, la superficie con la funzionalità di DDSCAPS_PRIMARYSURFACE rappresenta ciò che viene visualizzato dall'occhio destro dell'utente. |
DDSCAPS_STANDARDVGAMODE |
Questa superficie è una superficie di modalità VGA standard e non una superficie ModeX. Questo flag non può essere usato in combinazione con il flag DDSCAPS_MODEX. |
DDSCAPS_SYSTEMMEMORY |
Questa memoria di superficie è stata allocata dalla memoria di sistema. Se questo bit di funzionalità è impostato dal driver Windows 2000 o versione successiva, DirectDraw è disabilitato. |
DDSCAPS_TEXTURE |
Questa superficie può essere usata come trama 3D. Non indica se la superficie viene usata per tale scopo. |
DDSCAPS_VIDEOMEMORY |
Questa superficie esiste nella memoria visualizzata. |
DDSCAPS_VIDEOPORT |
Questa superficie può ricevere dati da un oggetto VPE (Video Port Extensions). |
DDSCAPS_VISIBLE |
Le modifiche apportate a questa superficie sono immediatamente visibili. È sempre impostato per la superficie primaria, nonché per le sovrimpressione mentre sono sovrapponibili e mappe di trama mentre sono a trama. |
DDSCAPS_WRITEONLY |
Solo l'accesso in scrittura è consentito all'area. L'accesso in lettura dalla superficie può generare un errore di protezione generale (GPF), ma i risultati di lettura da questa superficie non sono significativi. Se questo bit di funzionalità è impostato dal driver Windows 2000 o versione successiva, DirectDraw è disabilitato. |
DDSCAPS_ZBUFFER |
Questa superficie è il buffer z. Contiene informazioni dettagliate bit usate per determinare quali pixel sono visibili e quali sono oscurati. Il buffer z contiene informazioni che non possono essere visualizzate. |
Commenti
Questa struttura viene usata dal driver per segnalare i tipi di superfici supportate dal driver. Viene inoltre compilato da un'applicazione per specificare il tipo di superficie da creare.
Requisiti
Requisito | Valore |
---|---|
Intestazione | ddraw.h |