Interfaccia IDirectDrawSurface7 (ddraw.h)
Le applicazioni usano i metodi dell'interfaccia IDirectDrawSurface7 per creare oggetti DirectDrawSurface e usare variabili a livello di sistema. Questa sezione è un riferimento ai metodi di questa interfaccia.
Ereditarietà
L'interfaccia IDirectDrawSurface7 eredita dall'interfaccia IUnknown . IDirectDrawSurface7 include anche questi tipi di membri:
Metodi
L'interfaccia IDirectDrawSurface7 include questi metodi.
| IDirectDrawSurface7::AddAttachedSurface Collega la superficie del buffer z specificata a questa superficie. |
| IDirectDrawSurface7::AddOverlayDirtyRect Il metodo IDirectDrawSurface7::AddOverlayDirtyRect non è attualmente implementato. |
| IDirectDrawSurface7::Blt Esegue un trasferimento di blocchi di bit (bitblt). Questo metodo non supporta la fusione z-buffering o alfa durante le operazioni bitblt. |
| IDirectDrawSurface7::BltBatch Il metodo IDirectDrawSurface7::BltBatch non è attualmente implementato. |
| IDirectDrawSurface7::BltFast Esegue un bitblt di copia di origine o un bitblt trasparente usando una chiave di colore di origine o una chiave colore di destinazione. |
| IDirectDrawSurface7::ChangeUniquenessValue Aggiorna manualmente il valore di univocità per questa superficie. |
| IDirectDrawSurface7::D eleteAttachedSurface Scollega una o più superfici associate. |
| IDirectDrawSurface7::EnumAttachedSurfaces Enumera tutte le superfici associate a questa superficie. |
| IDirectDrawSurface7::EnumOverlayZOrders Enumera le superfici sovrapposte nella destinazione specificata. È possibile enumerare le sovrimpressioni in ordine front-to-back o back-to-front. |
| IDirectDrawSurface7::Flip Rende la memoria di superficie associata alla superficie di DDSCAPS_BACKBUFFER diventa associata alla superficie del buffer anteriore. |
| IDirectDrawSurface7::FreePrivateData Libera i dati privati specificati associati a questa superficie. |
| IDirectDrawSurface7::GetAttachedSurface Ottiene la superficie associata con le funzionalità specificate e incrementa il conteggio dei riferimenti dell'interfaccia recuperata. |
| IDirectDrawSurface7::GetBltStatus Ottiene lo stato di un'operazione bit block transfer (bitblt). |
| IDirectDrawSurface7::GetCaps Recupera le funzionalità di questa superficie. Queste funzionalità non sono necessariamente correlate alle funzionalità del dispositivo di visualizzazione. |
| IDirectDrawSurface7::GetClipper Recupera l'oggetto DirectDrawClipper associato a questa superficie e incrementa il conteggio dei riferimenti della clipper restituita. |
| IDirectDrawSurface7::GetColorKey Recupera il valore della chiave di colore per questa superficie. |
| IDirectDrawSurface7::GetDC Crea un handle compatibile con GDI di un contesto di dispositivo per questa superficie. |
| IDirectDrawSurface7::GetDDInterface Recupera un'interfaccia per l'oggetto DirectDraw utilizzato per creare questa superficie. |
| IDirectDrawSurface7::GetFlipStatus Recupera lo stato relativo al completamento del processo di capovolgimento della superficie. |
| IDirectDrawSurface7::GetLOD Recupera il livello massimo di dettaglio (LOD) attualmente impostato per una superficie mipmap gestita. Questo metodo ha esito positivo solo sulle trame gestite. |
| IDirectDrawSurface7::GetOverlayPosition Recupera le coordinate di visualizzazione di questa superficie. Questo metodo viene usato su una superficie di sovrimpressione visibile e attiva, ovvero una superficie con il flag DDSCAPS_OVERLAY impostato. |
| IDirectDrawSurface7::GetPalette Recupera l'oggetto DirectDrawPalette associato a questa superficie e incrementa il conteggio dei riferimenti della tavolozza restituita. |
| IDirectDrawSurface7::GetPixelFormat Recupera il colore e il formato pixel di questa superficie. |
| IDirectDrawSurface7::GetPriority Recupera la priorità di gestione delle trame per questa trama. Questo metodo ha esito positivo solo sulle trame gestite. |
| IDirectDrawSurface7::GetPrivateData Copia i dati privati associati a questa superficie in un buffer specificato. |
| IDirectDrawSurface7::GetSurfaceDesc Recupera una descrizione di questa superficie nella condizione corrente. |
| IDirectDrawSurface7::GetUniquenessValue Recupera il valore di univocità corrente per questa superficie. |
| IDirectDrawSurface7::Initialize Inizializza un oggetto DirectDrawSurface. |
| IDirectDrawSurface7::IsLost Determina se la memoria della superficie associata a un oggetto DirectDrawSurface è stata liberata. |
| IDirectDrawSurface7::Lock Ottiene un puntatore alla memoria superficiale. |
| IDirectDrawSurface7::P ageLock Impedisce il paging di una superficie di memoria di sistema mentre è in corso un'operazione bit block transfer (bitblt) che usa trasferimenti DMA (Direct Memory Access) verso o dalla memoria di sistema. |
| IDirectDrawSurface7::P ageUnlock Sblocca una superficie di memoria di sistema, che consente quindi di eseguire il paging. |
| IDirectDrawSurface7::ReleaseDC Rilascia l'handle di un contesto di dispositivo ottenuto in precedenza usando il metodo IDirectDrawSurface7::GetDC. |
| IDirectDrawSurface7::Restore Ripristina una superficie persa. Ciò si verifica quando la memoria della superficie associata all'oggetto DirectDrawSurface è stata liberata. |
| IDirectDrawSurface7::SetClipper Collega un oggetto clipper a o ne elimina uno da questa superficie. |
| IDirectDrawSurface7::SetColorKey Imposta il valore della chiave di colore per l'oggetto DirectDrawSurface se l'hardware supporta i tasti di colore in base alla superficie. |
| IDirectDrawSurface7::SetLOD Imposta il livello massimo di dettaglio (LOD) per una superficie mipmap gestita. Questo metodo ha esito positivo solo sulle trame gestite. |
| IDirectDrawSurface7::SetOverlayPosition Modifica le coordinate di visualizzazione di una superficie di sovrapposizione. |
| IDirectDrawSurface7::SetPalette Collega un oggetto tavolozza a (o scollega uno da) una superficie. La superficie usa questa tavolozza per tutte le operazioni successive. La modifica della tavolozza avviene immediatamente, senza considerare l'intervallo di aggiornamento. |
| IDirectDrawSurface7::SetPriority Assegna la priorità di gestione della trama per questa trama. Questo metodo ha esito positivo solo sulle trame gestite. |
| IDirectDrawSurface7::SetPrivateData Associa i dati alla superficie destinata all'uso dall'applicazione, non da DirectDraw. I dati vengono passati per valore e è possibile associare più set di dati a una singola superficie. |
| IDirectDrawSurface7::SetSurfaceDesc Imposta le caratteristiche di una superficie esistente. |
| IDirectDrawSurface7::Unlock Notifica a DirectDraw che le manipolazioni della superficie diretta sono complete. |
| IDirectDrawSurface7::UpdateOverlay Riposiziona o modifica gli attributi visivi di una superficie di sovrapposizione. Queste superfici devono avere il flag di DDSCAPS_OVERLAY impostato. |
| IDirectDrawSurface7::UpdateOverlayDisplay Il metodo IDirectDrawSurface7::UpdateOverlayDisplay non è attualmente implementato. |
| IDirectDrawSurface7::UpdateOverlayZOrder Imposta l'ordine z di una sovrapposizione. |
Commenti
I metodi dell'interfaccia IDirectDrawSurface7 possono essere organizzati nei gruppi seguenti:
| Gruppo | Metodi |
|---|---|
| Allocazione della memoria | Inizializzare, IsLost e Restore |
| Superfici di collegamento | AddAttachedSurface, DeleteAttachedSurface, EnumAttachedSurfaces e GetAttachedSurface |
| BitBltting | Blt, BltBatch, BltFast e GetBltStatus |
| Tasti di colore | GetColorKey e SetColorKey |
| Contesti di dispositivo | GetDC e ReleaseDC |
| Lanciando | Capovolgi e GetFlipStatus |
| Superfici di blocco | Blocco, PageLock, PageUnlock e Sblocco |
| Varie | GetDDInterface |
| Sovrimpressioni | AddOverlayDirtyRect, EnumOverlayZOrders, GetOverlayPosition, SetOverlayPosition, UpdateOverlay, UpdateOverlayDisplay e UpdateOverlayZOrder |
| Dati di superficie privata | FreePrivateData, GetPrivateData e SetPrivateData |
| Funzionalità di Surface | GetCaps |
| Clipper superficie | GetClipper e SetClipper |
| Caratteristiche della superficie | ChangeUniquenessValue, GetPixelFormat, GetSurfaceDesc, GetUniquenessValue e SetSurfaceDesc |
| Tavolozze di superficie | GetPalette e SetPalette |
| Trame | GetLOD, GetPriority, SetLOD e SetPriority |
L'interfaccia IDirectDrawSurface7 estende le funzionalità delle versioni precedenti dell'interfaccia offrendo metodi che offrono una migliore gestione della superficie e facilità d'uso. Molti metodi in questa interfaccia accettano parametri leggermente diversi rispetto alle loro controparti nelle versioni precedenti dell'interfaccia. Ovunque un metodo di interfaccia IDirectDrawSurface3 possa accettare una struttura DDSURFACEDESC o un'interfaccia IDirectDrawSurface3 , i metodi in IDirectDrawSurface7 accettano invece una struttura DDSURFACEDESC2 o un'interfaccia IDirectDrawSurface7 .
Usare il tipo di dati LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE2, LPDIRECTDRAWSURFACE3, LPDIRECTDRAWSURFACE4 o LPDIRECTDRAWSURFACE7 per dichiarare una variabile che punta a varie interfacce di oggetti DirectDrawSurface. Il file di intestazione Ddraw.h dichiara questi tipi di dati con il codice seguente:
typedef struct IDirectDrawSurface FAR *LPDIRECTDRAWSURFACE;
typedef struct IDirectDrawSurface2 FAR *LPDIRECTDRAWSURFACE2;
typedef struct IDirectDrawSurface3 FAR *LPDIRECTDRAWSURFACE3;
typedef struct IDirectDrawSurface4 FAR *LPDIRECTDRAWSURFACE4;
typedef struct IDirectDrawSurface7 FAR *LPDIRECTDRAWSURFACE7;
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |