Lire en anglais

Partager via


Directdraw

Vue d’ensemble de la technologie DirectDraw.

Pour développer DirectDraw, vous avez besoin des en-têtes suivants :

Pour obtenir des conseils de programmation pour cette technologie, consultez :

Fonctions

 
AddAttachedSurface

Attache la surface de mémoire tampon z spécifiée à cette surface.
AddOverlayDirtyRect

La méthode IDirectDrawSurface7::AddOverlayDirtyRect n’est actuellement pas implémentée.
Blt

Effectue un transfert de bloc de bits (bitblt). Cette méthode ne prend pas en charge la mise en mémoire tampon z ou la fusion alpha pendant les opérations bitblt.
BltBatch

La méthode IDirectDrawSurface7::BltBatch n’est actuellement pas implémentée.
BltFast

Effectue un bitblt de copie source ou un bitblt transparent à l’aide d’une clé de couleur source ou d’une clé de couleur de destination.
ChangeUniquenessValue

Met à jour manuellement la valeur d’unicité pour cette surface.
Compact

Cette méthode n'est pas implémentée à l'heure actuelle. (IDirectDraw7.Compact)
CreateClipper

Crée un objet DirectDrawClipper.
CreatePalette

Crée un objet DirectDrawPalette pour cet objet DirectDraw.
CreateSurface

Crée un objet DirectDrawSurface pour cet objet DirectDraw.
DeleteAttachedSurface

Détache une ou plusieurs surfaces attachées.
DirectDrawCreate

Crée un instance d’un objet DirectDraw.
DirectDrawCreateClipper

Crée une instance d’un objet DirectDrawClipper qui n’est pas associé à un objet DirectDraw.
DirectDrawCreateEx

Crée un instance d’un objet DirectDraw qui prend en charge l’ensemble d’interfaces Direct3D dans DirectX 7.0. Pour utiliser les fonctionnalités de Direct3D dans DirectX 7.0, créez un objet DirectDraw avec cette fonction.
DirectDrawEnumerateA

Cette fonction est remplacée par la fonction DirectDrawEnumerateEx. (ANSI)
DirectDrawEnumerateExA

Énumère tous les appareils DirectDraw installés sur l’ordinateur. L’entrée NULL identifie toujours le périphérique d’affichage principal partagé avec GDI. (ANSI)
DirectDrawEnumerateExW

Énumère tous les appareils DirectDraw installés sur l’ordinateur. L’entrée NULL identifie toujours le périphérique d’affichage principal partagé avec GDI. (Unicode)
DirectDrawEnumerateW

Cette fonction est remplacée par la fonction DirectDrawEnumerateEx. (Unicode)
DuplicateSurface

Dupliquer un objet DirectDrawSurface.
EnumAttachedSurfaces

Énumère toutes les surfaces qui sont attachées à cette surface.
EnumDisplayModes

Énumère tous les modes d’affichage que le matériel expose via l’objet DirectDraw et qui sont compatibles avec une description de surface fournie.
EnumOverlayZOrders

Énumère les surfaces de superposition sur la destination spécifiée. Vous pouvez énumérer les superpositions dans l’ordre de l’avant ou de l’avant.
EnumSurfaces

Énumère toutes les surfaces existantes ou possibles qui répondent à la description de surface spécifiée.
EvaluateMode

Utilisé après un appel à IDirectDraw7::StartModeTest pour réussir ou échouer chaque mode présenté par le test et pour parcourir les modes jusqu’à la fin du test.
Flip

Rend la mémoire de surface associée à l’DDSCAPS_BACKBUFFER surface deviennent associées à la surface de mémoire tampon frontale.
FlipToGDISurface

Crée la surface que le GDI écrit dans la surface primaire.
FreePrivateData

Libère les données privées spécifiées associées à cette surface.
GetAttachedSurface

Obtient la surface attachée qui a les fonctionnalités spécifiées et incrémente le nombre de références de l’interface récupérée.
GetAvailableVidMem

Récupère la quantité totale de mémoire d’affichage disponible et la quantité de mémoire d’affichage actuellement libre pour un type de surface donné.
GetBltStatus

Obtient status sur une opération de transfert de bloc de bits (bitblt).
GetCaps

Récupère les fonctionnalités du pilote de périphérique pour le matériel et la couche d’émulation matérielle (HEL).
GetCaps

Récupère les fonctionnalités de l’objet palette.
GetCaps

Récupère les fonctionnalités de cette surface. Ces fonctionnalités ne sont pas nécessairement liées aux fonctionnalités de l’appareil d’affichage.
GetClipList

Récupère une copie de la liste de clips associée à un objet DirectDrawClipper. Pour sélectionner un sous-ensemble de la liste de clips, vous pouvez passer un rectangle qui clipse la liste de clips.
GetClipper

Récupère l’objet DirectDrawClipper associé à cette surface et incrémente le nombre de références du clipper retourné.
GetColorControls

Récupère les paramètres de contrôle de couleur actuels associés à une superposition ou à une surface primaire.
GetColorKey

Récupère la valeur de la clé de couleur pour cette surface.
GetDC

Crée un handle compatible GDI d’un contexte d’appareil pour cette surface.
GetDDInterface

Récupère une interface de l’objet DirectDraw qui a été utilisée pour créer cette surface.
GetDeviceIdentifier

Obtient des informations sur le pilote de périphérique. Cette méthode peut être utilisée, avec précaution, pour reconnaître des installations matérielles spécifiques afin d’implémenter des solutions de contournement pour un comportement médiocre des pilotes ou des chipsets.
GetDisplayMode

Récupère le mode d’affichage actuel.
GetEntries

Récupère les valeurs de palette d’un objet DirectDrawPalette.
GetFlipStatus

Récupère status de savoir si cette surface a terminé son processus de basculement.
GetFourCCCodes

Récupère les codes de quatre caractères (FOURCC) pris en charge par l’objet DirectDraw. Cette méthode peut également récupérer le nombre de codes pris en charge.
GetGammaRamp

Récupère les rampes gamma rouges, vertes et bleues pour la surface primaire.
GetGDISurface

Récupère l’objet DirectDrawSurface qui représente actuellement la mémoire de surface que GDI traite comme surface principale.
GetHWnd

Récupère le handle de fenêtre précédemment associé à cet objet DirectDrawClipper par la méthode IDirectDrawClipper::SetHWnd.
GetLOD

Récupère le niveau de détail maximal (LOD) actuellement défini pour une surface mipmap managée. Cette méthode réussit uniquement sur les textures managées.
GetMonitorFrequency

Récupère la fréquence du moniteur que l’objet DirectDraw contrôle.
GetOverlayPosition

Récupère les coordonnées d’affichage de cette surface. Cette méthode est utilisée sur une surface de superposition visible et active (c’est-à-dire une surface dont l’indicateur DDSCAPS_OVERLAY est défini).
GetPalette

Récupère l’objet DirectDrawPalette associé à cette surface et incrémente le nombre de références de la palette retournée.
GetPixelFormat

Récupère la couleur et le format de pixels de cette surface.
GetPriority

Récupère la priorité de gestion des textures pour cette texture. Cette méthode réussit uniquement sur les textures managées.
GetPrivateData

Copie les données privées associées à cette surface dans une mémoire tampon fournie.
GetScanLine

Récupère la ligne d’analyse en cours d’dessin sur le moniteur.
GetSurfaceDesc

Récupère une description de cette surface dans son état actuel.
GetSurfaceFromDC

Récupère l’interface IDirectDrawSurface7 pour une surface, en fonction de son handle de contexte d’appareil GDI.
GetUniquenessValue

Récupère la valeur d’unicité actuelle pour cette surface.
GetVerticalBlankStatus

Récupère le status du vide vertical.
Initialiser

Initialise un objet DirectDraw créé à l’aide de la fonction COM CoCreateInstance.
Initialiser

Initialise un objet DirectDrawClipper créé à l’aide de la fonction COM CoCreateInstance.
Initialiser

Initialise l’objet DirectDrawPalette.
Initialiser

Initialise un objet DirectDrawSurface.
IsClipListChanged

Récupère le status de la liste de clips si un handle de fenêtre est associé à un objet DirectDrawClipper.
IsLost

Détermine si la mémoire surface associée à un objet DirectDrawSurface a été libérée.
Verrou

Obtient un pointeur vers la mémoire surface.
LPDDENUMCALLBACKA

La fonction DDEnumCallback est une fonction de rappel définie par l’application pour la fonction DirectDrawEnumerate. (ANSI)
LPDDENUMCALLBACKEXA

La fonction DDEnumCallbackEx est une fonction de rappel définie par l’application pour la fonction DirectDrawEnumerateEx. (ANSI)
LPDDENUMCALLBACKEXW

La fonction DDEnumCallbackEx est une fonction de rappel définie par l’application pour la fonction DirectDrawEnumerateEx. (Unicode)
LPDDENUMCALLBACKW

La fonction DDEnumCallback est une fonction de rappel définie par l’application pour la fonction DirectDrawEnumerate. (Unicode)
LPDDENUMMODESCALLBACK

Ne pas utiliser. Cette fonction de rappel est remplacée par la fonction EnumModesCallback2 utilisée avec la méthode IDirectDraw7::EnumDisplayModes.
LPDDENUMMODESCALLBACK2

La fonction EnumModesCallback2 est une fonction de rappel définie par l’application pour la méthode IDirectDraw7::EnumDisplayModes.
LPDDENUMSURFACESCALLBACK

La fonction LPDDENUMSURFACESCALLBACK (ddraw.h) est remplacée par la fonction EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK2

La fonction LPDDENUMSURFACESCALLBACK2 (ddraw.h) est remplacée par la fonction EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK7

La fonction EnumSurfacesCallback7 est une fonction de rappel définie par l’application pour les méthodes IDirectDrawSurface7::EnumAttachedSurfaces et IDirectDrawSurface7::EnumOverlayZOrders.
Pagelock

Empêche une surface de mémoire système d’être paginée alors qu’une opération de transfert de bloc de bits (bitblt) qui utilise des transferts d’accès direct à la mémoire (DMA) vers ou à partir de la mémoire système est en cours.
PageUnlock

Déverrouille une surface de mémoire système, ce qui lui permet ensuite d’être paginée.
ReleaseDC

Libère le handle d’un contexte d’appareil précédemment obtenu à l’aide de la méthode IDirectDrawSurface7::GetDC.
Restauration

Restaure une surface qui a été perdue. Cela se produit lorsque la mémoire surface associée à l’objet DirectDrawSurface a été libérée.
RestoreAllSurfaces

Restaure toutes les surfaces qui ont été créées pour l’objet DirectDraw, dans l’ordre dans lequel elles ont été créées.
RestoreDisplayMode

Réinitialise le mode du matériel de l’appareil d’affichage pour la surface primaire à ce qu’il était avant l’appel de la méthode IDirectDraw7::SetDisplayMode. Un accès de niveau exclusif est requis pour utiliser cette méthode.
SetClipList

Définit ou supprime la liste de clips utilisée par les méthodes IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch et IDirectDrawSurface7::UpdateOverlay sur les surfaces auxquelles l’objet DirectDrawClipper parent est attaché.
SetClipper

Attache un objet clipper à cette surface ou en supprime un.
SetColorControls

Définit les options de contrôle des couleurs pour une superposition ou une surface primaire.
SetColorKey

Définit la valeur de la clé de couleur pour l’objet DirectDrawSurface si le matériel prend en charge les clés de couleur sur une base par surface.
SetCooperativeLevel

Détermine le comportement de niveau supérieur de l’application.
SetDisplayMode

Définit le mode du matériel de périphérique d’affichage.
SetEntries

Modifie immédiatement les entrées d’un objet DirectDrawPalette.
SetGammaRamp

Définit les rampes gamma rouges, vertes et bleues pour la surface primaire.
SetHWnd

Définit la poignée de fenêtre que l’objet clipper utilise pour obtenir des informations de découpage.
SetLOD

Définit le niveau de détail maximal (LOD) pour une surface mipmap managée. Cette méthode réussit uniquement sur les textures managées.
SetOverlayPosition

Modifie les coordonnées d’affichage d’une surface de superposition.
SetPalette

Attache un objet de palette à une surface (ou en détache un. La surface utilise cette palette pour toutes les opérations suivantes. Le changement de palette a lieu immédiatement, sans tenir compte du moment d’actualisation.
SetPriority

Affecte la priorité de gestion des textures pour cette texture. Cette méthode réussit uniquement sur les textures managées.
SetPrivateData

Associe des données à la surface destinée à être utilisées par l’application, et non par DirectDraw. Les données sont transmises par valeur et plusieurs jeux de données peuvent être associés à une surface unique.
SetSurfaceDesc

Définit les caractéristiques d’une surface existante.
StartModeTest

Lance un test pour mettre à jour le registre système avec des informations sur la fréquence d’actualisation pour la combinaison actuelle de l’adaptateur d’affichage et du moniteur.
TestCooperativeLevel

Indique la status de niveau coopératif actuelle de l’appareil DirectDraw pour une application fenêtré ou plein écran.
Déverrouiller

Avertit DirectDraw que les manipulations de surface directe sont terminées.
UpdateOverlay

Repositionne ou modifie les attributs visuels d’une surface de superposition. L’indicateur DDSCAPS_OVERLAY doit être défini sur ces surfaces.
UpdateOverlayDisplay

La méthode IDirectDrawSurface7::UpdateOverlayDisplay n’est actuellement pas implémentée.
UpdateOverlayZOrder

Définit l’ordre z d’une superposition.
WaitForVerticalBlank

Aide l’application à se synchroniser avec l’intervalle vide vertical.

Interfaces

 
IDirectDraw7

Les applications utilisent les méthodes de l’interface IDirectDraw7 pour créer des objets DirectDraw et utiliser des variables au niveau du système. Cette section est une référence aux méthodes de l’interface IDirectDraw7.
IDirectDrawClipper

Les applications utilisent les méthodes de l’interface IDirectDrawClipper pour gérer les listes de clip. Cette section est une référence aux méthodes de cette interface.
IDirectDrawColorControl

Les applications utilisent les méthodes de l’interface IDirectDrawColorControl pour obtenir et définir des contrôles de couleur.
IDirectDrawGammaControl

Les applications utilisent les méthodes de l’interface IDirectDrawGammaControl pour ajuster les niveaux de rampe gamma rouge, vert et bleu de la surface primaire. Cette section est une référence aux méthodes de cette interface.
IDirectDrawPalette

Les applications utilisent les méthodes de l’interface IDirectDrawPalette pour créer des objets DirectDrawPalette et utiliser des variables au niveau du système. Cette section est une référence aux méthodes de cette interface.
IDirectDrawSurface7

Les applications utilisent les méthodes de l’interface IDirectDrawSurface7 pour créer des objets DirectDrawSurface et utiliser des variables au niveau du système. Cette section est une référence aux méthodes de cette interface.

Structures

 
DDCOLORCONTROL

La structure DDCOLORCONTROL définit les contrôles de couleur associés à un objet d’extensions de port vidéo (VPE) Microsoft DirectDraw.
DDSURFACEDESC

La structure DDSURFACEDESC contient une description d’une surface à créer par le pilote.
DDSURFACEDESC2

La structure DDSURFACEDESC2 contient une description d’une surface à créer par le pilote.
DDBLTBATCH

La structure DDBLTBATCH transmet les opérations de transfert de bloc de bits (bitblt) à la méthode IDirectDrawSurface7::BltBatch.
DDBLTFX

La structure DDBLTFX transmet les opérations raster (ROPs), les effets et les informations de remplacement à la méthode IDirectDrawSurface7::Blt. Cette structure fait également partie de la structure DDBLTBATCH utilisée avec la méthode IDirectDrawSurface7::BltBatch.
DDCAPS_DX3

La structure DDCAPS_DX3 (ddraw.h) représente les fonctionnalités du matériel exposé via l’objet DirectDraw.
DDCAPS_DX5

La structure DDCAPS_DX5 (ddraw.h) représente les fonctionnalités du matériel exposé via l’objet DirectDraw.
DDCAPS_DX6

La structure DDCAPS_DX6 (ddraw.h) représente les fonctionnalités du matériel exposé via l’objet DirectDraw.
DDCAPS_DX7

La structure DDCAPS_DX7 (ddraw.h) représente les fonctionnalités du matériel exposé via l’objet DirectDraw.
DDCOLORKEY

La structure DDCOLORKEY décrit une clé de couleur source, une clé de couleur de destination ou un espace de couleur.
DDDEVICEIDENTIFIER2

La structure DDDEVICEIDENTIFIER2 est passée à la méthode IDirectDraw7::GetDeviceIdentifier pour obtenir des informations sur un appareil.
DDGAMMARAMP

La structure DDGAMMARAMP contient des données de rampe rouge, verte et bleue pour les méthodes IDirectDrawGammaControl::GetGammaRamp et IDirectDrawGammaControl::SetGammaRamp.
DDOVERLAYFX

La structure DDOVERLAYFX transmet les informations de superposition à la méthode IDirectDrawSurface7::UpdateOverlay.
DDPIXELFORMAT

La structure DDPIXELFORMAT décrit le format de pixel d’un objet DirectDrawSurface pour la méthode IDirectDrawSurface7::GetPixelFormat.
DDSCAPS

La structure DDSCAPS définit les fonctionnalités d’un objet surface Microsoft DirectDraw.
DDSCAPS2

La structure DDSCAPS2 définit des fonctionnalités supplémentaires d’un objet surface Microsoft DirectDraw.