Auf Englisch lesen

Freigeben über


Directdraw

Übersicht über die DirectDraw-Technologie.

Zum Entwickeln von DirectDraw benötigen Sie die folgenden Header:

Programmieranleitungen für diese Technologie finden Sie unter:

Functions

 
AddAttachedSurface

Fügt die angegebene Z-Pufferoberfläche an diese Oberfläche an.
AddOverlayDirtyRect

Die IDirectDrawSurface7::AddOverlayDirtyRect-Methode ist derzeit nicht implementiert.
Blt

Führt eine Bitblockübertragung (Bitblt) aus. Diese Methode unterstützt bei Bitblt-Vorgängen keine Z-Pufferung oder Alphamischung.
BltBatch

Die IDirectDrawSurface7::BltBatch-Methode ist derzeit nicht implementiert.
BltFast

Führt eine Bitblt- oder transparente Bitblt-Quellkopie mithilfe eines Quellfarbschlüssels oder Zielfarbschlüssels aus.
ChangeUniquenessValue

Aktualisiert den Eindeutigkeitswert für diese Oberfläche manuell.
Kompakt

Diese Methode ist derzeit nicht implementiert. (IDirectDraw7.Compact)
CreateClipper

Erstellt ein DirectDrawClipper-Objekt.
CreatePalette

Erstellt ein DirectDrawPalette-Objekt für dieses DirectDraw-Objekt.
CreateSurface

Erstellt ein DirectDrawSurface-Objekt für dieses DirectDraw-Objekt.
DeleteAttachedSurface

Trennt eine oder mehrere angefügte Flächen.
DirectDrawCreate

Erstellt eine instance eines DirectDraw-Objekts.
DirectDrawCreateClipper

Erstellt eine instance eines DirectDrawClipper-Objekts, das keinem DirectDraw-Objekt zugeordnet ist.
DirectDrawCreateEx

Erstellt eine instance eines DirectDraw-Objekts, das den Satz von Direct3D-Schnittstellen in DirectX 7.0 unterstützt. Um die Features von Direct3D in DirectX 7.0 zu verwenden, erstellen Sie mit dieser Funktion ein DirectDraw-Objekt.
DirectDrawEnumerateA

Diese Funktion wird von der DirectDrawEnumerateEx-Funktion abgelöst. (ANSI)
DirectDrawEnumerateExA

Listet alle DirectDraw-Geräte auf, die auf dem Computer installiert sind. Der NULL-Eintrag identifiziert immer das primäre Anzeigegerät, das für GDI freigegeben wird. (ANSI)
DirectDrawEnumerateExW

Listet alle DirectDraw-Geräte auf, die auf dem Computer installiert sind. Der NULL-Eintrag identifiziert immer das primäre Anzeigegerät, das für GDI freigegeben wird. (Unicode)
DirectDrawEnumerateW

Diese Funktion wird von der DirectDrawEnumerateEx-Funktion abgelöst. (Unicode)
DuplicateSurface

Dupliziert ein DirectDrawSurface-Objekt.
EnumAttachedSurfaces

Listet alle Oberflächen auf, die an dieser Oberfläche angebracht sind.
EnumDisplayModes

Listet alle Anzeigemodi auf, die die Hardware über das DirectDraw-Objekt verfügbar macht und die mit einer bereitgestellten Oberflächenbeschreibung kompatibel sind.
EnumOverlayZOrders

Listet die Überlagerungsflächen auf dem angegebenen Ziel auf. Sie können die Überlagerungen in vorderer oder back-to-front-Reihenfolge aufzählen.
EnumSurfaces

Listet alle vorhandenen oder möglichen Oberflächen auf, die der angegebenen Oberflächenbeschreibung entsprechen.
EvaluateMode

Wird nach einem Aufruf von IDirectDraw7::StartModeTest verwendet, um jeden modus, den der Test darstellt, zu bestehen oder fehlzuschlagen und die Modi zu durchlaufen, bis der Test abgeschlossen ist.
Kippen

Bewirkt, dass der Surface-Speicher, der der DDSCAPS_BACKBUFFER Oberfläche zugeordnet ist, der Frontpufferoberfläche zugeordnet wird.
FlipToGDISurface

Macht die Oberfläche, die der GDI in die primäre Oberfläche schreibt.
FreePrivateData

Gibt die angegebenen privaten Daten frei, die dieser Oberfläche zugeordnet sind.
GetAttachedSurface

Ruft die angefügte Oberfläche ab, die über die angegebenen Funktionen verfügt, und erhöht die Verweisanzahl der abgerufenen Schnittstelle.
GetAvailableVidMem

Ruft die Gesamtmenge des verfügbaren Anzeigespeichers und die Menge an Anzeigespeicher ab, die derzeit für einen bestimmten Oberflächentyp frei ist.
GetBltStatus

Ruft status zu einem Bitblockübertragungsvorgang (Bitblt) ab.
GetCaps

Ruft die Funktionen des Gerätetreibers für die Hardware und die Hardwareemulationsebene (HEL) ab.
GetCaps

Ruft die Funktionen des Palettenobjekts ab.
GetCaps

Ruft die Funktionen dieser Oberfläche ab. Diese Funktionen beziehen sich nicht unbedingt auf die Funktionen des Anzeigegeräts.
GetClipList

Ruft eine Kopie der Clipliste ab, die einem DirectDrawClipper-Objekt zugeordnet ist. Um eine Teilmenge der Clipliste auszuwählen, können Sie ein Rechteck übergeben, das die Clipliste ausschneidet.
GetClipper

Ruft das DirectDrawClipper-Objekt ab, das dieser Oberfläche zugeordnet ist, und erhöht die Verweisanzahl des zurückgegebenen Clippers.
GetColorControls

Ruft die aktuellen Farbsteuerungseinstellungen ab, die einer Überlagerung oder einer primären Oberfläche zugeordnet sind.
GetColorKey

Ruft den Farbschlüsselwert für diese Oberfläche ab.
GetDC

Erstellt ein GDI-kompatibles Handle eines Gerätekontexts für diese Oberfläche.
GetDDInterface

Ruft eine Schnittstelle für das DirectDraw-Objekt ab, das zum Erstellen dieser Oberfläche verwendet wurde.
GetDeviceIdentifier

Ruft Informationen zum Gerätetreiber ab. Diese Methode kann mit Vorsicht verwendet werden, um bestimmte Hardwareinstallationen zu erkennen, um Problemumgehungen für schlechtes Treiber- oder Chipsatzverhalten zu implementieren.
GetDisplayMode

Ruft den aktuellen Anzeigemodus ab.
Getentries

Ruft Palettenwerte aus einem DirectDrawPalette-Objekt ab.
GetFlipStatus

Ruft status ab, ob diese Oberfläche ihren Kehrvorgang abgeschlossen hat.
GetFourCCCodes

Ruft die vierstelligen Codes (FOURCC) ab, die vom DirectDraw-Objekt unterstützt werden. Diese Methode kann auch die Anzahl der unterstützten Codes abrufen.
GetGammaRamp

Ruft die roten, grünen und blauen Gamma-Rampen für die primäre Oberfläche ab.
GetGDISurface

Ruft das DirectDrawSurface-Objekt ab, das derzeit den Oberflächenspeicher darstellt, den GDI als primäre Oberfläche behandelt.
GetHWnd

Ruft das Fensterhandle ab, das diesem DirectDrawClipper-Objekt zuvor von der IDirectDrawClipper::SetHWnd-Methode zugeordnet wurde.
GetLOD

Ruft die maximale Detailebene (Maximum Level of Detail, LOD) ab, die derzeit für eine verwaltete Mipmap-Oberfläche festgelegt ist. Diese Methode ist nur bei verwalteten Texturen erfolgreich.
GetMonitorFrequency

Ruft die Häufigkeit des Monitors ab, den das DirectDraw-Objekt steuert.
GetOverlayPosition

Ruft die Anzeigekoordinaten dieser Oberfläche ab. Diese Methode wird auf einer sichtbaren, aktiven Überlagerungsoberfläche (d. a. einer Oberfläche mit festgelegtem DDSCAPS_OVERLAY Flag) verwendet.
GetPalette

Ruft das DirectDrawPalette-Objekt ab, das dieser Oberfläche zugeordnet ist, und erhöht die Verweisanzahl der zurückgegebenen Palette.
GetPixelFormat

Ruft die Farbe und das Pixelformat dieser Oberfläche ab.
GetPriority

Ruft die Texturverwaltungspriorität für diese Textur ab. Diese Methode ist nur bei verwalteten Texturen erfolgreich.
GetPrivateData

Kopiert die privaten Daten, die dieser Oberfläche zugeordnet sind, in einen bereitgestellten Puffer.
GetScanLine

Ruft die Scanlinie ab, die derzeit auf dem Monitor gezeichnet wird.
GetSurfaceDesc

Ruft eine Beschreibung dieser Oberfläche in ihrem aktuellen Zustand ab.
GetSurfaceFromDC

Ruft die IDirectDrawSurface7-Schnittstelle für eine Oberfläche basierend auf dem GDI-Gerätekontexthandle ab.
GetUniquenessValue

Ruft den aktuellen Eindeutigkeitswert für diese Oberfläche ab.
GetVerticalBlankStatus

Ruft die status des vertikalen Leerzeichens ab.
Initialisieren

Initialisiert ein DirectDraw-Objekt, das mit der COM-Funktion CoCreateInstance erstellt wurde.
Initialisieren

Initialisiert ein DirectDrawClipper-Objekt, das mit der COM-Funktion CoCreateInstance erstellt wurde.
Initialisieren

Initialisiert das DirectDrawPalette-Objekt.
Initialisieren

Initialisiert ein DirectDrawSurface-Objekt.
IsClipListChanged

Ruft die status der Clipliste ab, wenn einem DirectDrawClipper-Objekt ein Fensterhandle zugeordnet ist.
IsLost

Bestimmt, ob der Surface-Speicher, der einem DirectDrawSurface-Objekt zugeordnet ist, freigegeben wurde.
Sperre

Ruft einen Zeiger auf den Oberflächenspeicher ab.
LPDDENUMCALLBACKA

Die DDEnumCallback-Funktion ist eine anwendungsdefinierte Rückruffunktion für die DirectDrawEnumerate-Funktion. (ANSI)
LPDDENUMCALLBACKEXA

Die DDEnumCallbackEx-Funktion ist eine anwendungsdefinierte Rückruffunktion für die DirectDrawEnumerateEx-Funktion. (ANSI)
LPDDENUMCALLBACKEXW

Die DDEnumCallbackEx-Funktion ist eine anwendungsdefinierte Rückruffunktion für die DirectDrawEnumerateEx-Funktion. (Unicode)
LPDDENUMCALLBACKW

Die DDEnumCallback-Funktion ist eine anwendungsdefinierte Rückruffunktion für die DirectDrawEnumerate-Funktion. (Unicode)
LPDDENUMMODESCALLBACK

Darf nicht verwendet werden. Diese Rückruffunktion wird durch die EnumModesCallback2-Funktion ersetzt, die mit der IDirectDraw7::EnumDisplayModes-Methode verwendet wird.
LPDDENUMMODESCALLBACK2

Die Funktion EnumModesCallback2 ist eine anwendungsdefinierte Rückruffunktion für die IDirectDraw7::EnumDisplayModes-Methode.
LPDDENUMSURFACESCALLBACK

Die LPDDENUMSURFACESCALLBACK-Funktion (ddraw.h) wird durch die Funktion EnumSurfacesCallback7 abgelöst.
LPDDENUMSURFACESCALLBACK2

Die LPDDENUMSURFACESCALLBACK2-Funktion (ddraw.h) wird durch die Funktion EnumSurfacesCallback7 ersetzt.
LPDDENUMSURFACESCALLBACK7

Die Funktion EnumSurfacesCallback7 ist eine anwendungsdefinierte Rückruffunktion für die Methoden IDirectDrawSurface7::EnumAttachedSurfaces und IDirectDrawSurface7::EnumOverlayZOrders.
PageLock

Verhindert, dass eine Systemspeicheroberfläche ausgelagert wird, während ein Bitblockübertragungsvorgang (Bitblt), der DMA-Übertragungen (Direct Memory Access) zum oder vom Systemspeicher verwendet, ausgeführt wird.
PageUnlock

Entsperrt eine Systemspeicheroberfläche, sodass sie dann ausgelagert werden kann.
ReleaseDC

Gibt das Handle eines Gerätekontexts frei, der zuvor mithilfe der IDirectDrawSurface7::GetDC-Methode abgerufen wurde.
Wiederherstellen

Stellt eine verloren gegangene Oberfläche wieder her. Dies tritt auf, wenn der dem DirectDrawSurface-Objekt zugeordnete Oberflächenspeicher freigegeben wurde.
RestoreAllSurfaces

Stellt alle Oberflächen, die für das DirectDraw-Objekt erstellt wurden, in der Reihenfolge wieder her, in der sie erstellt wurden.
RestoreDisplayMode

Setzt den Modus der Anzeigegerätehardware für die primäre Oberfläche auf den Wert zurück, der vor dem Aufruf der IDirectDraw7::SetDisplayMode-Methode war. Für die Verwendung dieser Methode ist Zugriff auf exklusiver Ebene erforderlich.
SetClipList

Legt die Clipliste fest, die von den Methoden IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch und IDirectDrawSurface7::UpdateOverlay auf Oberflächen verwendet wird, an die das übergeordnete DirectDrawClipper-Objekt angefügt ist, oder löscht sie.
SetClipper

Fügt ein Clipper-Objekt an diese Oberfläche an oder löscht ein Objekt aus dieser Oberfläche.
SetColorControls

Legt die Farbsteuerungsoptionen für eine Überlagerung oder eine primäre Oberfläche fest.
Setcolorkey

Legt den Farbschlüsselwert für das DirectDrawSurface-Objekt fest, wenn die Hardware Farbtasten pro Oberfläche unterstützt.
SetCooperativeLevel

Bestimmt das Verhalten der Anwendung auf oberster Ebene.
SetDisplayMode

Legt den Modus der Anzeigegerätehardware fest.
SetEntries

Ändert Einträge in einem DirectDrawPalette-Objekt sofort.
SetGammaRamp

Legt die roten, grünen und blauen Gammarampen für die primäre Oberfläche fest.
SetHWnd

Legt das Fensterhandle fest, das vom Clipper-Objekt zum Abrufen von Clippinginformationen verwendet wird.
SetLOD

Legt die maximale Detailebene (Maximum Level of Detail, LOD) für eine verwaltete Mipmap-Oberfläche fest. Diese Methode ist nur bei verwalteten Texturen erfolgreich.
SetOverlayPosition

Ändert die Anzeigekoordinaten einer Überlagerungsfläche.
SetPalette

Fügt ein Palettenobjekt an eine Oberfläche an (oder trennt es davon). Die Oberfläche verwendet diese Palette für alle nachfolgenden Vorgänge. Der Palettenwechsel erfolgt sofort, ohne Berücksichtigung des Aktualisierungszeitpunkts.
SetPriority

Weist die Texturverwaltungspriorität für diese Textur zu. Diese Methode ist nur bei verwalteten Texturen erfolgreich.
SetPrivateData

Ordnet Daten der Oberfläche zu, die für die Verwendung durch die Anwendung und nicht für DirectDraw vorgesehen ist. Daten werden nach Wert übergeben, und einer einzelnen Oberfläche können mehrere Datasets zugeordnet werden.
SetSurfaceDesc

Legt die Merkmale einer vorhandenen Oberfläche fest.
StartModeTest

Initiiert einen Test, um die Systemregistrierung mit Informationen zur Aktualisierungsrate für die aktuelle Anzeigeadapter- und Monitorkombination zu aktualisieren.
TestCooperativeLevel

Meldet die aktuelle status des DirectDraw-Geräts auf kooperativer Ebene für eine Fenster- oder Vollbildanwendung.
Entsperren

Benachrichtigt DirectDraw, dass die direkten Oberflächenbearbeitungen abgeschlossen sind.
UpdateOverlay

Positioniert oder ändert die visuellen Attribute einer Überlagerungsoberfläche. Für diese Oberflächen muss das flag DDSCAPS_OVERLAY festgelegt sein.
UpdateOverlayDisplay

Die IDirectDrawSurface7::UpdateOverlayDisplay-Methode ist derzeit nicht implementiert.
UpdateOverlayZOrder

Legt die Z-Reihenfolge einer Überlagerung fest.
WaitForVerticalBlank

Hilft der Anwendung, sich selbst mit dem vertikal-leeren Intervall zu synchronisieren.

Schnittstellen

 
IDirectDraw7

Anwendungen verwenden die Methoden der IDirectDraw7-Schnittstelle, um DirectDraw-Objekte zu erstellen und mit Variablen auf Systemebene zu arbeiten. Dieser Abschnitt enthält einen Verweis auf die Methoden der IDirectDraw7-Schnittstelle.
IDirectDrawClipper

Anwendungen verwenden die Methoden der IDirectDrawClipper-Schnittstelle, um Cliplisten zu verwalten. Dieser Abschnitt enthält einen Verweis auf die Methoden dieser Schnittstelle.
IDirectDrawColorControl

Anwendungen verwenden die Methoden der IDirectDrawColorControl-Schnittstelle, um Farbsteuerelemente abzurufen und festzulegen.
IDirectDrawGammaControl

Anwendungen verwenden die Methoden der IDirectDrawGammaControl-Schnittstelle, um die rote, grüne und blaue Gammarampe der primären Oberfläche anzupassen. Dieser Abschnitt enthält einen Verweis auf die Methoden dieser Schnittstelle.
IDirectDrawPalette

Anwendungen verwenden die Methoden der IDirectDrawPalette-Schnittstelle, um DirectDrawPalette-Objekte zu erstellen und mit Variablen auf Systemebene zu arbeiten. Dieser Abschnitt enthält einen Verweis auf die Methoden dieser Schnittstelle.
IDirectDrawSurface7

Anwendungen verwenden die Methoden der IDirectDrawSurface7-Schnittstelle, um DirectDrawSurface-Objekte zu erstellen und mit Variablen auf Systemebene zu arbeiten. Dieser Abschnitt enthält einen Verweis auf die Methoden dieser Schnittstelle.

Strukturen

 
DDCOLORCONTROL

Die DDCOLORCONTROL-Struktur definiert die Farbsteuerelemente, die einem VpE-Objekt (Microsoft DirectDraw Video Port Extensions) zugeordnet sind.
DDSURFACEDESC

Die DDSURFACEDESC-Struktur enthält eine Beschreibung einer Oberfläche, die vom Treiber erstellt werden soll.
DDSURFACEDESC2

Die DDSURFACEDESC2-Struktur enthält eine Beschreibung einer Oberfläche, die vom Treiber erstellt werden soll.
DDBLTBATCH

Die DDBLTBATCH-Struktur übergibt Bitblockübertragungsvorgänge (Bitblt) an die IDirectDrawSurface7::BltBatch-Methode.
DDBLTFX

Die DDBLTFX-Struktur übergibt Rastervorgänge (RoPs), Effekte und Überschreibungsinformationen an die IDirectDrawSurface7::Blt-Methode. Diese Struktur ist auch Teil der DDBLTBATCH-Struktur, die mit der IDirectDrawSurface7::BltBatch-Methode verwendet wird.
DDCAPS_DX3

Die DDCAPS_DX3-Struktur (ddraw.h) stellt die Funktionen der Hardware dar, die über das DirectDraw-Objekt verfügbar gemacht wird.
DDCAPS_DX5

Die DDCAPS_DX5-Struktur (ddraw.h) stellt die Funktionen der Hardware dar, die über das DirectDraw-Objekt verfügbar gemacht wird.
DDCAPS_DX6

Die DDCAPS_DX6-Struktur (ddraw.h) stellt die Funktionen der Hardware dar, die über das DirectDraw-Objekt verfügbar gemacht wird.
DDCAPS_DX7

Die DDCAPS_DX7-Struktur (ddraw.h) stellt die Funktionen der Hardware dar, die über das DirectDraw-Objekt verfügbar gemacht wird.
DDCOLORKEY

Die DDCOLORKEY-Struktur beschreibt einen Quellfarbschlüssel, einen Zielfarbschlüssel oder einen Farbraum.
DDDEVICEIDENTIFIER2

Die DDDEVICEIDENTIFIER2-Struktur wird an die IDirectDraw7::GetDeviceIdentifier-Methode übergeben, um Informationen zu einem Gerät abzurufen.
DDGAMMARAMP

Die DDGAMMARAMP-Struktur enthält rote, grüne und blaue Rampendaten für die Methoden IDirectDrawGammaControl::GetGammaRamp und IDirectDrawGammaControl::SetGammaRamp.
DDOVERLAYFX

Die DDOVERLAYFX-Struktur übergibt Overlayinformationen an die IDirectDrawSurface7::UpdateOverlay-Methode.
DDPIXELFORMAT

Die DDPIXELFORMAT-Struktur beschreibt das Pixelformat eines DirectDrawSurface-Objekts für die IDirectDrawSurface7::GetPixelFormat-Methode.
DDSCAPS

Die DDSCAPS-Struktur definiert die Funktionen eines Microsoft DirectDraw-Oberflächenobjekts.
DDSCAPS2

Die DDSCAPS2-Struktur definiert zusätzliche Funktionen eines Microsoft DirectDraw-Oberflächenobjekts.