Interfaccia IDirectDraw7 (ddraw.h)
Le applicazioni usano i metodi dell'interfaccia IDirectDraw7 per creare oggetti DirectDraw e usare variabili a livello di sistema. Questa sezione è un riferimento ai metodi dell'interfaccia IDirectDraw7 .
Ereditarietà
L'interfaccia IDirectDraw7 eredita dall'interfaccia IUnknown . IDirectDraw7 include anche questi tipi di membri:
Metodi
L'interfaccia IDirectDraw7 include questi metodi.
| IDirectDraw7::Compact Non è attualmente implementato. (IDirectDraw7.Compact) |
| IDirectDraw7::CreateClipper Crea un oggetto DirectDrawClipper. |
| IDirectDraw7::CreatePalette Crea un oggetto DirectDrawPalette per questo oggetto DirectDraw. |
| IDirectDraw7::CreateSurface Crea un oggetto DirectDrawSurface per questo oggetto DirectDraw. |
| IDirectDraw7::D uplicateSurface Duplica un oggetto DirectDrawSurface. |
| IDirectDraw7::EnumDisplayModes Enumera tutte le modalità di visualizzazione esposte dall'hardware tramite l'oggetto DirectDraw e compatibili con una descrizione della superficie specificata. |
| IDirectDraw7::EnumSurfaces Enumera tutte le superfici esistenti o possibili che soddisfano la descrizione della superficie specificata. |
| IDirectDraw7::EvaluateMode Usato dopo una chiamata a IDirectDraw7::StartModeTest per passare o non riuscire ogni modalità che il test presenta e per eseguire le modalità fino al completamento del test. |
| IDirectDraw7::FlipToGDISurface Rende la superficie che il GDI scrive nella superficie primaria. |
| IDirectDraw7::GetAvailableVidMem Recupera la quantità totale di memoria di visualizzazione disponibile e la quantità di memoria visualizzato attualmente disponibile per un determinato tipo di superficie. |
| IDirectDraw7::GetCaps Recupera le funzionalità del driver di dispositivo per l'hardware e il livello di emulazione hardware (HEL). |
| IDirectDraw7::GetDeviceIdentifier Ottiene informazioni sul driver del dispositivo. Questo metodo può essere usato, con attenzione, per riconoscere installazioni hardware specifiche per implementare soluzioni alternative per il comportamento di driver o chipset scarso. |
| IDirectDraw7::GetDisplayMode Recupera la modalità di visualizzazione corrente. |
| IDirectDraw7::GetFourCCCodes Recupera i codici a quattro caratteri (FOURCC) supportati dall'oggetto DirectDraw. Questo metodo può anche recuperare il numero di codici supportati. |
| IDirectDraw7::GetGDISurface Recupera l'oggetto DirectDrawSurface che attualmente rappresenta la memoria di superficie che GDI tratta come superficie primaria. |
| IDirectDraw7::GetMonitorFrequency Recupera la frequenza del monitoraggio che controlla l'oggetto DirectDraw. |
| IDirectDraw7::GetScanLine Recupera la linea di analisi attualmente disegnata sul monitor. |
| IDirectDraw7::GetSurfaceFromDC Recupera l'interfaccia IDirectDrawSurface7 per una superficie, in base all'handle del contesto del dispositivo GDI. |
| IDirectDraw7::GetVerticalBlankStatus Recupera lo stato del vuoto verticale. |
| IDirectDraw7::Initialize Inizializza un oggetto DirectDraw creato usando la funzione COM CoCreateInstance. |
| IDirectDraw7::RestoreAllSurfaces Ripristina tutte le superfici create per l'oggetto DirectDraw, nell'ordine di creazione. |
| IDirectDraw7::RestoreDisplayMode Reimposta la modalità dell'hardware del dispositivo visualizzato per la superficie primaria a quello che era prima della chiamata del metodo IDirectDraw7::SetDisplayMode. L'accesso a livello esclusivo è necessario per usare questo metodo. |
| IDirectDraw7::SetCooperativeLevel Determina il comportamento principale dell'applicazione. |
| IDirectDraw7::SetDisplayMode Imposta la modalità dell'hardware del dispositivo visualizzato. |
| IDirectDraw7::StartModeTest Avvia un test per aggiornare il Registro di sistema con informazioni sulla frequenza di aggiornamento per la combinazione corrente della scheda di visualizzazione e del monitoraggio. |
| IDirectDraw7::TestCooperativeLevel Segnala lo stato corrente a livello di cooperativa del dispositivo DirectDraw per un'applicazione con finestra o a schermo intero. |
| IDirectDraw7::WaitForVerticalBlank Consente all'applicazione di sincronizzarsi con l'intervallo vuoto verticale. |
Commenti
I metodi dell'interfaccia IDirectDraw7 possono essere organizzati nei gruppi seguenti:
| Gruppo | Metodi |
|---|---|
| Allocazione della memoria | Compattare e inizializzare |
| Livelli cooperativi | SetCooperativeLevel e TestCooperativeLevel |
| Creazione di oggetti | CreateClipper, CreatePalette e CreateSurface |
| Funzionalità di dispositivo | GetCaps |
| Modalità di visualizzazione | EnumDisplayModes, GetDisplayMode, GetMonitorFrequency, RestoreDisplayMode, SetDisplayMode e WaitForVerticalBlank |
| Stato visualizzazione | GetScanLine e GetVerticalBlankStatus |
| Varie | EvaluateMode, GetAvailableVidMem, GetDeviceIdentifier, GetFourCCCodes e StartModeTest |
| Gestione della superficie | DuplicateSurface, EnumSurfaces, FlipToGDISurface, GetGDISurface, GetSurfaceFromDC e RestoreAllSurfaces |
L'interfaccia IDirectDraw7 estende le funzionalità delle versioni precedenti dell'interfaccia offrendo metodi che consentono la gestione più flessibile della superficie rispetto alle versioni precedenti. Tutti i metodi correlati alla superficie nell'interfaccia IDirectDraw7 accettano parametri leggermente diversi rispetto alle loro controparti nell'interfaccia IDirectDraw2 . Ovunque un metodo di interfaccia IDirectDraw2 possa accettare una struttura DDSURFACEDESC e recuperare un'interfaccia IDirectDrawSurface3, i metodi in IDirectDraw7 accettano invece una struttura DDSURFACEDESC2 e recuperano un'interfaccia IDirectDrawSurface7.
IDirectDraw7 introduce una maggiore conformità con le regole COM che determinano la durata degli oggetti figlio.
Usare i tipi di dati LPDIRECTDRAW, LPDIRECTDRAW2, LPDIRECTDRAW4 o LPDIRECTDRAW7 per dichiarare una variabile contenente un puntatore a un'interfaccia IDirectDraw, IDirectDraw2, IDirectDraw4 o IDirectDraw7 . Il file di intestazione Ddraw.h dichiara questi tipi di dati con il codice seguente:
typedef struct IDirectDraw FAR *LPDIRECTDRAW;
typedef struct IDirectDraw2 FAR *LPDIRECTDRAW2;
typedef struct IDirectDraw4 FAR *LPDIRECTDRAW4;
typedef struct IDirectDraw7 FAR *LPDIRECTDRAW7;
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |