DDCAPS_DX3 structure (ddraw.h)

La structure DDCAPS représente les fonctionnalités du matériel exposé via l’objet DirectDraw. Cette structure contient une structure DDSCAPS2 utilisée dans ce contexte pour décrire les types d’objets DirectDrawSurface qui peuvent être créés. Il n’est peut-être pas possible de créer simultanément toutes les surfaces décrites par ces fonctionnalités. Cette structure est utilisée avec la méthode IDirectDraw7::GetCaps .

Le fichier d’en-tête Ddraw.h contient plusieurs versions de cette structure (par exemple, DDCAPS_DX7). Pour plus d’informations sur la façon de déterminer la version à utiliser, consultez Remarques.

Syntaxe

typedef struct _DDCAPS_DX3 {
  DWORD   dwSize;
  DWORD   dwCaps;
  DWORD   dwCaps2;
  DWORD   dwCKeyCaps;
  DWORD   dwFXCaps;
  DWORD   dwFXAlphaCaps;
  DWORD   dwPalCaps;
  DWORD   dwSVCaps;
  DWORD   dwAlphaBltConstBitDepths;
  DWORD   dwAlphaBltPixelBitDepths;
  DWORD   dwAlphaBltSurfaceBitDepths;
  DWORD   dwAlphaOverlayConstBitDepths;
  DWORD   dwAlphaOverlayPixelBitDepths;
  DWORD   dwAlphaOverlaySurfaceBitDepths;
  DWORD   dwZBufferBitDepths;
  DWORD   dwVidMemTotal;
  DWORD   dwVidMemFree;
  DWORD   dwMaxVisibleOverlays;
  DWORD   dwCurrVisibleOverlays;
  DWORD   dwNumFourCCCodes;
  DWORD   dwAlignBoundarySrc;
  DWORD   dwAlignSizeSrc;
  DWORD   dwAlignBoundaryDest;
  DWORD   dwAlignSizeDest;
  DWORD   dwAlignStrideAlign;
  DWORD   dwRops[DD_ROP_SPACE];
  DDSCAPS ddsCaps;
  DWORD   dwMinOverlayStretch;
  DWORD   dwMaxOverlayStretch;
  DWORD   dwMinLiveVideoStretch;
  DWORD   dwMaxLiveVideoStretch;
  DWORD   dwMinHwCodecStretch;
  DWORD   dwMaxHwCodecStretch;
  DWORD   dwReserved1;
  DWORD   dwReserved2;
  DWORD   dwReserved3;
  DWORD   dwSVBCaps;
  DWORD   dwSVBCKeyCaps;
  DWORD   dwSVBFXCaps;
  DWORD   dwSVBRops[DD_ROP_SPACE];
  DWORD   dwVSBCaps;
  DWORD   dwVSBCKeyCaps;
  DWORD   dwVSBFXCaps;
  DWORD   dwVSBRops[DD_ROP_SPACE];
  DWORD   dwSSBCaps;
  DWORD   dwSSBCKeyCaps;
  DWORD   dwSSBFXCaps;
  DWORD   dwSSBRops[DD_ROP_SPACE];
  DWORD   dwReserved4;
  DWORD   dwReserved5;
  DWORD   dwReserved6;
} DDCAPS_DX3;

Membres

dwSize

Taille de la structure, en octets. Ce membre doit être initialisé avant l’utilisation de la structure.

dwCaps

Cette valeur se compose d’un ou plusieurs des indicateurs suivants qui spécifient les fonctionnalités matérielles et de pilotes.

DDCAPS_3D

Le matériel d’affichage a une accélération 3D.

DDCAPS_ALIGNBOUNDARYDEST

DirectDraw prend en charge uniquement les rectangles de destination de superposition avec l’axe x aligné sur les limites dwAlignBoundaryDest de la surface.

DDCAPS_ALIGNBOUNDARYSRC

DirectDraw prend uniquement en charge ces rectangles sources de superposition avec l’axe X aligné sur les limites dwAlignBoundarySrc de la surface.

DDCAPS_ALIGNSIZEDEST

DirectDraw prend uniquement en charge les rectangles de destination de superposition dont les tailles d’axe X, en pixels, sont des multiples dwAlignSizeDest .

DDCAPS_ALIGNSIZESRC

DirectDraw prend uniquement en charge les rectangles sources de superposition dont les tailles d’axe X, en pixels, sont des multiples dwAlignSizeSrc .

DDCAPS_ALIGNSTRIDE

DirectDraw crée des surfaces de mémoire d’affichage dont l’alignement de la foulée est égal à la valeur dwAlignStrideAlign .

DDCAPS_ALPHA

Le matériel d’affichage prend en charge les surfaces alpha uniquement.

DDCAPS_BANKSWITCHED

Le matériel d’affichage est basculé et peut être très lent à l’accès aléatoire à la mémoire d’affichage.

DDCAPS_BLT

Le matériel d’affichage est capable d’opérations de transfert de blocs de bits (bitblt).

DDCAPS_BLTCOLORFILL

Le matériel d’affichage est capable de remplir les couleurs avec un blitter.

DDCAPS_BLTDEPTHFILL

Le matériel d’affichage est capable de remplir la profondeur z-buffers avec un blitter.

DDCAPS_BLTFOURCC

Le matériel d’affichage est capable de conversions d’espace de couleur pendant les opérations de bitblt.

DDCAPS_BLTQUEUE

Le matériel d’affichage est capable d’opérations de bitblt asynchrones.

DDCAPS_BLTSTRETCH

Le matériel d’affichage est capable de s’étirer pendant les opérations bitblt.

DDCAPS_CANBLTSYSMEM

Le matériel d’affichage est capable de blitting vers ou depuis la mémoire système.

DDCAPS_CANCLIP

Le matériel d’affichage est capable de couper avec un blitting.

DDCAPS_CANCLIPSTRETCHED

Le matériel d’affichage est capable de couper tout en étirant la fente.

DDCAPS_COLORKEY

Prend en charge une certaine forme de clé de couleur dans les opérations de superposition ou de bitblt. Vous trouverez des informations plus spécifiques sur les fonctionnalités de clé de couleur dans le membre dwCKeyCaps .

DDCAPS_COLORKEYHWASSIST

La clé de couleur est partiellement assistée par le matériel. Cela signifie que d’autres ressources (processeur ou mémoire vidéo) peuvent être utilisées. Si ce bit n’est pas défini, la prise en charge matérielle complète est en place.

DDCAPS_GDI

Le matériel d’affichage est partagé avec GDI.

DDCAPS_NOHARDWARE

Il n’existe aucune prise en charge matérielle.

DDCAPS_OVERLAY

Le matériel d’affichage prend en charge les superpositions.

DDCAPS_OVERLAYCANTCLIP

Le matériel d’affichage prend en charge les superpositions, mais ne peut pas les découper.

DDCAPS_OVERLAYFOURCC

Le matériel de superposition est capable de conversions d’espace de couleur pendant les opérations de superposition.

DDCAPS_OVERLAYSTRETCH

Le matériel de superposition est capable de s’étirer. Les membres dwMinOverlayStretch et dwMaxOverlayStretch contiennent des données valides.

DDCAPS_PALETTE

DirectDraw est capable de créer et de prendre en charge des objets DirectDrawPalette pour des surfaces autres que la surface primaire.

DDCAPS_PALETTEVSYNC

DirectDraw est capable de mettre à jour une palette synchronisée avec l’actualisation verticale.

DDCAPS_READSCANLINE

Le matériel d’affichage est capable de retourner la ligne d’analyse actuelle.

DDCAPS_VBI

Le matériel d’affichage est capable de générer une interruption vide verticale.

DDCAPS_ZBLTS

Prend en charge l’utilisation de z-buffers avec des opérations bitblt.

DDCAPS_ZOVERLAYS

Prend en charge l’utilisation de la méthode IDirectDrawSurface7::UpdateOverlayZOrder comme valeur z pour les superpositions afin de contrôler leur superposition.

dwCaps2

Cette valeur se compose d’un ou plusieurs des indicateurs suivants qui spécifient davantage de fonctionnalités matérielles et de pilotes.

DDCAPS2_AUTOFLIPOVERLAY

La superposition peut être automatiquement retournée à la surface suivante dans la chaîne de basculement chaque fois qu’un port vidéo VSYNC se produit, ce qui permet au port vidéo et à la superposition de double-mettre en mémoire tampon la vidéo sans surcharge du processeur. Cette option n’est valide que lorsque la surface reçoit des données d’un port vidéo. Si les données de port vidéo ne sont pas imbriquées ou non enregistrées, elles s’activent sur chaque VSYNC. Si les données sont entrelacées en mémoire, elles s’activent tous les autres VSYNC.

DDCAPS2_CANBOBHARDWARE

Le matériel de superposition peut afficher individuellement chaque champ d’un flux vidéo entrelacé.

DDCAPS2_CANBOBINTERLEAVED

Le matériel de superposition peut afficher chaque champ d’un flux vidéo entrelacé individuellement pendant qu’il est entrelacé en mémoire sans provoquer d’artefacts qui peuvent normalement se produire sans prise en charge matérielle spéciale. Cette option n’est valide que lorsque la surface reçoit des données d’un port vidéo et que la vidéo est zoomée au moins deux fois dans la direction verticale.

DDCAPS2_CANBOBNONINTERLEAVED

Le matériel de superposition peut afficher chaque champ d’un flux vidéo entrelacé individuellement alors qu’il n’est pas entrelacé en mémoire sans provoquer d’artefacts qui peuvent normalement se produire sans prise en charge matérielle spéciale. Cette option n’est valide que lorsque la surface reçoit des données d’un port vidéo et que la vidéo est zoomée au moins deux fois dans la direction verticale.

DDCAPS2_CANCALIBRATEGAMMA

Le système dispose d’un étalonneur qui peut ajuster automatiquement la rampe gamma afin que le résultat soit identique sur tous les systèmes qui ont un étalonneur. Pour appeler le étalonneur lors de la définition de nouveaux niveaux gamma, utilisez l’indicateur DDSGR_CALIBRATE lors de l’appel de la méthode IDirectDrawGammaControl::SetGammaRamp . L’étalonnage des rampes gamma entraîne une certaine surcharge de traitement et ne doit pas être utilisé fréquemment.

DDCAPS2_CANDROPZ16BIT

Les valeurs RVBZ seize bits peuvent être converties en valeurs RVB 16 bits. (Le système ne prend pas en charge les conversions 8 bits.)

DDCAPS2_CANFLIPODDEVEN

Le pilote est capable d’effectuer des opérations de retournement impaires et paires, comme spécifié par les indicateurs DDFLIP_ODD et DDFLIP_EVEN utilisés avec la méthode IDirectDrawSurface7::Flip .

DDCAPS2_CANMANAGETEXTURE

Le gestionnaire de textures Direct3D utilise cette fonctionnalité pour décider s’il faut placer des surfaces managées dans la mémoire vidéo non locale. Si la fonctionnalité est définie, le gestionnaire de texture place des surfaces managées dans la mémoire vidéo non locale. Les pilotes qui ne peuvent pas texturer à partir de la mémoire vidéo locale ne doivent pas définir cette fonctionnalité.

DDCAPS2_CANRENDERWINDOWED

Le pilote est capable de rendre le rendu en mode fenêtré.

DDCAPS2_CERTIFIED

Le matériel d’affichage est certifié.

DDCAPS2_COLORCONTROLPRIMARY

La surface primaire contient des contrôles de couleur (pour instance, gamma).

DDCAPS2_COLORCONTROLOVERLAY

La surface de superposition contient des contrôles de couleur (tels que la luminosité et la netteté).

DDCAPS2_COPYFOURCC

Le pilote prend en charge le blittage d’une surface FOURCC sur une autre surface du même FOURCC.

DDCAPS2_FLIPINTERVAL

Le pilote répond aux indicateurs DDFLIP_INTERVAL*. (Pour plus d’informations sur ces indicateurs, consultez IDirectDrawSurface7::Flip).

DDCAPS2_FLIPNOVSYNC

Le pilote répond à l’indicateur DDFLIP_NOVSYNC (pour plus d’informations sur cet indicateur, consultez IDirectDrawSurface7::Flip).

DDCAPS2_NO2DDURING3DSCENE

Les opérations bidimensionnelles telles que IDirectDrawSurface7::Blt et IDirectDrawSurface7::Lock ne peuvent pas être effectuées sur les surfaces utilisées par Direct3D entre les appels aux méthodes BeginScene et EndScene .

DDCAPS2_NONLOCALVIDMEM

Le pilote d’affichage prend en charge les surfaces dans la mémoire vidéo non locale.

DDCAPS2_NONLOCALVIDMEMCAPS

Les fonctionnalités de bitblt pour les surfaces de mémoire vidéo non locales diffèrent des surfaces de mémoire vidéo locales. Si cet indicateur est présent, l’indicateur DDCAPS2_NONLOCALVIDMEM est également présent.

DDCAPS2_NOPAGELOCKREQUIRED

Les opérations de bitblt DMA sont prises en charge sur les surfaces de mémoire système qui ne sont pas verrouillées par page.

DDCAPS2_PRIMARYGAMMA

Prend en charge les rampes gamma dynamiques pour la surface primaire.

DDCAPS2_STEREO

Nouveauté de DirectX 7.0. Active le bit dwSVCaps pour prendre en charge le mode stéréo. Le pilote peut effectuer la stéréo dans au moins un mode autre que le mode actuel. L’application peut utiliser IDirectDraw7::GetDisplayMode ou IDirectDraw7::EnumDisplayModes pour obtenir des informations stéréo par mode.

DDCAPS2_TEXMANINNONLOCALVIDMEM

Nouveauté de DirectX 7.0. Le gestionnaire de textures Direct3D utilise cette fonctionnalité pour décider s’il faut placer des surfaces managées dans la mémoire vidéo non locale. Si la fonctionnalité est définie, le gestionnaire de texture place des surfaces managées dans la mémoire vidéo non locale. Les pilotes qui ne peuvent pas texturer à partir de la mémoire vidéo locale ne doivent pas définir cette fonctionnalité.

DDCAPS2_VIDEOPORT

Le matériel d’affichage prend en charge la vidéo en direct.

DDCAPS2_WIDESURFACES

La surface d’affichage prend en charge des surfaces plus larges que la surface primaire.

dwCKeyCaps

Cette valeur se compose d’un ou plusieurs des indicateurs suivants qui spécifient des fonctionnalités de clé de couleur.

DDCKEYCAPS_DESTBLT

Prend en charge le blitting transparent avec une clé de couleur qui identifie les bits remplaçables de la surface de destination pour les couleurs RVB.

DDCKEYCAPS_DESTBLTCLRSPACE

Prend en charge la fente transparente avec un espace de couleurs qui identifie les bits remplaçables de la surface de destination pour les couleurs RVB.

DDCKEYCAPS_DESTBLTCLRSPACEYUV

Prend en charge le blitting transparent avec un espace de couleurs qui identifie les bits remplaçables de la surface de destination pour les couleurs YUV.

DDCKEYCAPS_DESTBLTYUV

Prend en charge le blitting transparent avec une clé de couleur qui identifie les bits remplaçables de la surface de destination pour les couleurs YUV.

DDCKEYCAPS_DESTOVERLAY

Prend en charge la superposition avec la touche de couleur des bits remplaçables de la surface de destination à superposer pour les couleurs RVB.

DDCKEYCAPS_DESTOVERLAYCLRSPACE

Prend en charge un espace de couleurs comme clé de couleur pour la destination des couleurs RVB.

DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV

Prend en charge un espace de couleurs comme clé de couleur pour la destination des couleurs YUV.

DDCKEYCAPS_DESTOVERLAYONEACTIVE

Prend en charge une seule valeur de clé de couleur de destination active pour les surfaces de superposition visibles.

DDCKEYCAPS_DESTOVERLAYYUV

Prend en charge la superposition, à l’aide de la touche de couleur des bits remplaçables de la surface de destination à superposer pour les couleurs YUV.

DDCKEYCAPS_NOCOSTOVERLAY

Indique qu’il n’existe aucun compromis de bande passante pour l’utilisation de la clé de couleur avec une superposition.

DDCKEYCAPS_SRCBLT

Prend en charge le blitting transparent, à l’aide de la touche de couleur pour la source avec cette surface pour les couleurs RVB.

DDCKEYCAPS_SRCBLTCLRSPACE

Prend en charge le blitting transparent, à l’aide d’un espace de couleurs pour la source avec cette surface pour les couleurs RVB.

DDCKEYCAPS_SRCBLTCLRSPACEYUV

Prend en charge le blitting transparent, à l’aide d’un espace de couleurs pour la source avec cette surface pour les couleurs YUV.

DDCKEYCAPS_SRCBLTYUV

Prend en charge le blitting transparent, à l’aide de la clé de couleur de la source avec cette surface pour les couleurs YUV.

DDCKEYCAPS_SRCOVERLAY

Prend en charge la superposition, à l’aide de la clé de couleur pour la source avec cette surface de superposition pour les couleurs RVB.

DDCKEYCAPS_SRCOVERLAYCLRSPACE

Prend en charge la superposition, en utilisant un espace de couleurs comme clé de couleur source pour la surface de superposition pour les couleurs RVB.

DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV

Prend en charge la superposition, en utilisant un espace de couleur comme clé de couleur source pour la surface de superposition pour les couleurs YUV.

DDCKEYCAPS_SRCOVERLAYONEACTIVE

Prend en charge une seule valeur de clé de couleur source active pour les surfaces de superposition visibles.

DDCKEYCAPS_SRCOVERLAYYUV

Prend en charge la superposition, en utilisant la clé de couleur pour la source avec cette surface de superposition pour les couleurs YUV.

dwFXCaps

Cette valeur se compose d’un ou plusieurs des indicateurs suivants qui spécifient les fonctionnalités d’étirement et d’effets du pilote.

DDFXCAPS_BLTALPHA

Prend en charge les opérations bitblt mixtes alpha.

DDFXCAPS_BLTARITHSTRETCHY

Utilise des opérations arithmétiques, plutôt que des techniques de doublement de pixels, pour étirer et réduire les surfaces pendant une opération bitblt. Se produit le long de l’axe y (verticalement).

DDFXCAPS_BLTARITHSTRETCHYN

Utilise des opérations arithmétiques, plutôt que des techniques de doublement de pixels, pour étirer et réduire les surfaces pendant une opération bitblt. Se produit le long de l’axe y (verticalement) et fonctionne uniquement pour l’étirement des entiers (×1, ×2, etc.).

DDFXCAPS_BLTFILTER

Le pilote peut effectuer un filtrage de reconstruction de surface pour les bitblts déformés.

DDFXCAPS_BLTMIRRORLEFTRIGHT

Prend en charge la mise en miroir de gauche à droite dans une opération bitblt.

DDFXCAPS_BLTMIRRORUPDOWN

Prend en charge la mise en miroir de haut en bas dans une opération bitblt.

DDFXCAPS_BLTROTATION

Prend en charge la rotation arbitraire dans une opération bitblt.

DDFXCAPS_BLTROTATION90

Prend en charge les rotations à 90 degrés dans une opération bitblt.

DDFXCAPS_BLTSHRINKX

Prend en charge la réduction arbitraire d’une surface le long de l’axe X (horizontalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTSHRINKXN

Prend en charge la réduction des entiers (×1, ×2, etc.) d’une surface le long de l’axe X (horizontalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTSHRINKY

Prend en charge la réduction arbitraire d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTSHRINKYN

Prend en charge la réduction des entiers (×1, ×2, etc.) d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTSTRETCHX

Prend en charge l’étirement arbitraire d’une surface le long de l’axe X (horizontalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTSTRETCHXN

Prend en charge l’étirement entier (×1, ×2, etc.) d’une surface le long de l’axe des X (horizontalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTSTRETCHY

Prend en charge l’étirement arbitraire d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTSTRETCHYN

Prend en charge l’étirement entier (×1, ×2, etc.) d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour les opérations bitblt.

DDFXCAPS_BLTTRANSFORM

Prend en charge les transformations géométriques (ou les déformations) pour les sprites à fentes. Les transformations ne sont actuellement pas prises en charge pour les opérations de bitblt explicites.

DDFXCAPS_OVERLAYALPHA

Prend en charge le mélange alpha pour les surfaces de superposition.

DDFXCAPS_OVERLAYARITHSTRETCHY

Utilise des opérations arithmétiques, plutôt que des techniques de doublement de pixels, pour étirer et réduire les surfaces de superposition. Se produit le long de l’axe y (verticalement).

DDFXCAPS_OVERLAYARITHSTRETCHYN

Utilise des opérations arithmétiques, plutôt que des techniques de doublement de pixels, pour étirer et réduire les surfaces de superposition. Se produit le long de l’axe y (verticalement) et fonctionne uniquement pour l’étirement des entiers (×1, ×2, etc.).

DDFXCAPS_OVERLAYFILTER

Prend en charge le filtrage de reconstruction de surface pour les sprites de superposition déformés. Le filtrage n’est actuellement pas pris en charge pour les surfaces de superposition explicitement affichées (celles affichées avec des appels à IDirectDrawSurface7::UpdateOverlay).

DDFXCAPS_OVERLAYMIRRORLEFTRIGHT

Prend en charge la mise en miroir des superpositions sur l’axe vertical.

DDFXCAPS_OVERLAYMIRRORUPDOWN

Prend en charge la mise en miroir des superpositions sur l’axe horizontal.

DDFXCAPS_OVERLAYSHRINKX

Prend en charge la réduction arbitraire d’une surface le long de l’axe X (horizontalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; elle n’indique pas que la réduction est disponible.

DDFXCAPS_OVERLAYSHRINKXN

Prend en charge la réduction des entiers (×1, ×2, etc.) d’une surface le long de l’axe X (horizontalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; elle n’indique pas que la réduction est disponible.

DDFXCAPS_OVERLAYSHRINKY

Prend en charge la réduction arbitraire d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; elle n’indique pas que la réduction est disponible.

DDFXCAPS_OVERLAYSHRINKYN

Prend en charge la réduction des entiers (×1, ×2, etc.) d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; elle n’indique pas que la réduction est disponible.

DDFXCAPS_OVERLAYSTRETCHX

Prend en charge l’étirement arbitraire d’une surface le long de l’axe X (horizontalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; cela n’indique pas que l’étirement est disponible.

DDFXCAPS_OVERLAYSTRETCHXN

Prend en charge l’étirement entier (×1, ×2, etc.) d’une surface le long de l’axe des X (horizontalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; cela n’indique pas que l’étirement est disponible.

DDFXCAPS_OVERLAYSTRETCHY

Prend en charge l’étirement arbitraire d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; cela n’indique pas que l’étirement est disponible.

DDFXCAPS_OVERLAYSTRETCHYN

Prend en charge l’étirement entier (×1, ×2, etc.) d’une surface le long de l’axe y (verticalement). Cet indicateur est valide uniquement pour DDSCAPS_OVERLAY surfaces. Cet indicateur indique uniquement les fonctionnalités d’une surface ; cela n’indique pas que l’étirement est disponible.

DDFXCAPS_OVERLAYTRANSFORM

Prend en charge les transformations géométriques (ou les déformations) pour les sprites de superposition. Les transformations ne sont actuellement pas prises en charge pour les surfaces de superposition explicitement affichées (celles affichées avec des appels à IDirectDrawSurface7::UpdateOverlay).

dwFXAlphaCaps

Cette valeur se compose d’un ou plusieurs des indicateurs suivants qui spécifient les fonctionnalités alpha du pilote.

DDFXALPHACAPS_BLTALPHAEDGEBLEND

Prend en charge la fusion alpha autour du bord d’une surface à touches de couleur source. Utilisé pour les opérations bitblt.

DDFXALPHACAPS_BLTALPHAPIXELS

Prend en charge les informations alpha au format pixel. La profondeur de bits des informations alpha au format de pixels peut être de 1, 2, 4 ou 8. La valeur alpha devient plus opaque à mesure que la valeur alpha augmente. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement transparente. Utilisé pour les opérations bitblt.

DDFXALPHACAPS_BLTALPHAPIXELSNEG

Prend en charge les informations alpha au format pixel. La profondeur de bits des informations alpha au format de pixels peut être de 1, 2, 4 ou 8. La valeur alpha devient plus transparente à mesure que la valeur alpha augmente. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement opaque. Cet indicateur ne peut être utilisé que si DDCAPS_ALPHA est défini. Utilisé pour les opérations bitblt.

DDFXALPHACAPS_BLTALPHASURFACES

Prend en charge les surfaces alpha uniquement. La profondeur de bits d’une surface alpha seule peut être de 1, 2, 4 ou 8. La valeur alpha devient plus opaque à mesure que la valeur alpha augmente. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement transparente. Utilisé pour les opérations bitblt.

DDFXALPHACAPS_BLTALPHASURFACESNEG

Indique que le canal alpha devient plus transparent à mesure que la valeur alpha augmente. La profondeur des données du canal alpha peut être de 1, 2, 4 ou 8. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement opaque. Cet indicateur ne peut être défini que si DDCAPS_ALPHA a été défini. Utilisé pour les opérations bitblt.

DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND

Prend en charge la fusion alpha autour du bord d’une surface à touches de couleur source. Utilisé pour les superpositions.

DDFXALPHACAPS_OVERLAYALPHAPIXELS

Prend en charge les informations alpha au format pixel. La profondeur de bits des informations alpha au format pixel peut être de 1, 2, 4 ou 8. La valeur alpha devient plus opaque à mesure que la valeur alpha augmente. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement transparente. Utilisé pour les superpositions.

DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG

Prend en charge les informations alpha au format pixel. La profondeur de bits des informations alpha au format pixel peut être de 1, 2, 4 ou 8. La valeur alpha devient plus transparente à mesure que la valeur alpha augmente. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement opaque. Cet indicateur ne peut être utilisé que si DDCAPS_ALPHA a été défini. Utilisé pour les superpositions.

DDFXALPHACAPS_OVERLAYALPHASURFACES

Prend en charge les surfaces alpha uniquement. La profondeur de bits d’une surface alpha seule peut être de 1, 2, 4 ou 8. La valeur alpha devient plus opaque à mesure que la valeur alpha augmente. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement transparente. Utilisé pour les superpositions.

DDFXALPHACAPS_OVERLAYALPHASURFACESNEG

Indique que le canal alpha devient plus transparent à mesure que la valeur alpha augmente. La profondeur des données du canal alpha peut être de 1, 2, 4 ou 8. Quelle que soit la profondeur des informations alpha, 0 est toujours la valeur entièrement opaque. Cet indicateur ne peut être utilisé que si DDCAPS_ALPHA a été défini. Utilisé pour les superpositions.

dwPalCaps

Cette valeur se compose d’un ou plusieurs des indicateurs suivants qui spécifient des fonctionnalités de palette.

DDPCAPS_1BIT

Prend en charge les palettes qui contiennent des entrées de couleur 1 bits (deux couleurs).

DDPCAPS_2BIT

Prend en charge les palettes qui contiennent des entrées de couleur 2 bits (quatre couleurs).

DDPCAPS_4BIT

Prend en charge les palettes qui contiennent des entrées de couleur 4 bits (16 couleurs).

DDPCAPS_8BIT

Prend en charge les palettes qui contiennent des entrées de couleur 8 bits (256 couleurs).

DDPCAPS_8BITENTRIES

Spécifie un index à un index de couleur 8 bits. Ce champ n’est valide que s’il est utilisé avec la fonctionnalité DDPCAPS_1BIT, DDPCAPS_2BIT ou DDPCAPS_4BIT et lorsque la surface cible est de 8 bits par pixel (bpp). Chaque entrée de couleur a une longueur d'1 octet et est un index d’une palette de 8 bpp sur la surface de destination.

DDPCAPS_ALPHA

Prend en charge les palettes qui incluent un composant alpha. Pour les palettes alpha, le membre peFlags de chaque structure PALETTEENTRY que contient la palette doit être interprété comme une seule valeur alpha 8 bits (en plus des données de couleur dans les membres peRed, peGreen et peBlue ). Une palette créée avec cet indicateur ne peut être attachée qu’à une surface de texture.

DDPCAPS_ALLOW256

Prend en charge les palettes qui peuvent avoir toutes les 256 entrées définies.

DDPCAPS_PRIMARYSURFACE

La palette est attachée à la surface primaire. La modification de la palette a un effet immédiat sur l’affichage, sauf si la fonctionnalité DDPCAPS_VSYNC est spécifiée et prise en charge.

DDPCAPS_PRIMARYSURFACELEFT

La palette est attachée à la surface primaire à gauche. La modification de la palette a un effet immédiat sur l’affichage, sauf si la fonctionnalité DDPCAPS_VSYNC est spécifiée et prise en charge.

DDPCAPS_VSYNC

La palette peut être modifiée de manière synchrone avec la fréquence d’actualisation du moniteur.

dwSVCaps

Cette valeur se compose d’un ou plusieurs des indicateurs suivants qui spécifient des fonctionnalités de vision stéréo.

DDSVCAPS_RESERVED1, DDSVCAPS_RESERVED2, DDSVCAPS_RESERVED3, DDSVCAPS_RESERVED4

Indicateurs réservés.

DDSVCAPS_STEREOSEQUENTIAL

Nouveauté de DirectX 7.0. Le pilote peut effectuer la stéréo dans au moins un mode autre que le mode actuel. L’application peut utiliser IDirectDraw7::GetDisplayMode ou IDirectDraw7::EnumDisplayModes pour obtenir des informations stéréo par mode.

dwAlphaBltConstBitDepths

DDBD_2, DDBD_4 ou DDBD_8. (Indiquez 2, 4 ou 8 bits par pixel.)

dwAlphaBltPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indiquez 1, 2, 4 ou 8 bits par pixel.)

dwAlphaBltSurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indiquez 1, 2, 4 ou 8 bits par pixel.)

dwAlphaOverlayConstBitDepths

DDBD_2, DDBD_4 ou DDBD_8. (Indiquez 2, 4 ou 8 bits par pixel.)

dwAlphaOverlayPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indiquez 1, 2, 4 ou 8 bits par pixel.)

dwAlphaOverlaySurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 ou DDBD_8. (Indiquez 1, 2, 4 ou 8 bits par pixel.)

dwZBufferBitDepths

DDBD_8, DDBD_16, DDBD_24 ou DDBD_32. (Indiquez 8, 16, 24 ou 32 bits par pixel.) Ce membre est obsolète pour DirectX 6.0 et versions ultérieures. Utilisez IDirect3D7::EnumZBufferFormats pour récupérer des informations sur les formats de mémoire tampon de profondeur pris en charge.

dwVidMemTotal

Quantité totale de mémoire d’affichage sur l’appareil, en octets, moins la mémoire réservée pour la surface principale et toutes les structures de données privées réservées par le pilote. (Cette valeur est identique à la mémoire vidéo totale signalée par la méthode IDirectDraw7::GetAvailableVidMem .)

dwVidMemFree

Mémoire d’affichage libre. Cette valeur est égale à la valeur dans dwVidMemTotal, moins toute mémoire actuellement allouée par l’application pour les surfaces. Contrairement à la méthode IDirectDraw7::GetAvailableVidMem , qui indique la mémoire disponible pour un type particulier de surface (comme une texture), cette valeur reflète la mémoire disponible pour n’importe quel type de surface.

dwMaxVisibleOverlays

Nombre maximal de superpositions visibles ou de sprites de superposition.

dwCurrVisibleOverlays

Nombre actuel de superpositions visibles ou de sprites de superposition.

dwNumFourCCCodes

Nombre de codes FourCC.

dwAlignBoundarySrc

Alignement du rectangle source pour une surface de superposition, en pixels.

dwAlignSizeSrc

Alignement de la taille du rectangle source pour une surface de superposition, en pixels. Les rectangles sources de superposition doivent avoir une largeur de pixels qui est un multiple de cette valeur.

dwAlignBoundaryDest

Alignement rectangle de destination pour une surface de superposition, en pixels.

dwAlignSizeDest

Alignement de la taille du rectangle de destination pour une surface de superposition, en pixels. Les rectangles de destination de superposition doivent avoir une largeur de pixels qui est un multiple de cette valeur.

dwAlignStrideAlign

Alignement de la foulée.

dwRops[DD_ROP_SPACE]

Opérations raster prises en charge.

ddsCaps

Structure DDSCAPS2 qui contient des fonctionnalités de surface générale.

dwMinOverlayStretch

Facteur d’étirement de superposition minimal, multiplié par 1000. Par exemple, 1.3 = 1300.

dwMaxOverlayStretch

Facteur d’étirement de superposition maximal, multiplié par 1000. Par exemple, 1.3 = 1300.

dwMinLiveVideoStretch

Obsolète; n’utilisez pas.

dwMaxLiveVideoStretch

Obsolète; n’utilisez pas.

dwMinHwCodecStretch

Obsolète; n’utilisez pas.

dwMaxHwCodecStretch

Obsolète; n’utilisez pas.

dwReserved1

Réservé

dwReserved2

Réservé

dwReserved3

Réservé

dwSVBCaps

Fonctionnalités spécifiques aux pilotes pour les bitblts de la mémoire système à la mémoire d’affichage. Les indicateurs valides sont identiques aux indicateurs liés au bitblt qui sont utilisés avec le membre dwCaps .

dwSVBCKeyCaps

Fonctionnalités de clé de couleur du pilote pour les bitblts de la mémoire système à la mémoire d’affichage. Les indicateurs valides sont identiques aux indicateurs liés aux bits utilisés avec le membre dwCKeyCaps .

dwSVBFXCaps

Fonctionnalités FX du pilote pour les bitblts de la mémoire système à la mémoire d’affichage. Les indicateurs valides sont identiques aux indicateurs liés au bitblt qui sont utilisés avec le membre dwFXCaps .

dwSVBRops[DD_ROP_SPACE]

Opérations raster prises en charge pour les bitblts de la mémoire système à la mémoire d’affichage.

dwVSBCaps

Fonctionnalités spécifiques aux pilotes pour les bitblts de la mémoire d’affichage à la mémoire système. Les indicateurs valides sont identiques aux indicateurs liés au bitblt qui sont utilisés avec le membre dwCaps .

dwVSBCKeyCaps

Fonctionnalités de clé de couleur du pilote pour les bits de la mémoire d’affichage à la mémoire système. Les indicateurs valides sont identiques aux indicateurs liés aux bits utilisés avec le membre dwCKeyCaps .

dwVSBFXCaps

Fonctionnalités FX du pilote pour les bitblts de la mémoire d’affichage à la mémoire système. Les indicateurs valides sont identiques aux indicateurs liés au bitblt utilisés avec le membre dwFXCaps .

dwVSBRops[DD_ROP_SPACE]

Opérations raster prises en charge pour les bitblts de la mémoire d’affichage à la mémoire système.

dwSSBCaps

Fonctionnalités spécifiques aux pilotes pour les bitblts de la mémoire système à la mémoire système. Les indicateurs valides sont identiques aux indicateurs liés au bitblt utilisés avec le membre dwCaps .

dwSSBCKeyCaps

Fonctionnalités de clé couleur du pilote pour les bitblts de la mémoire système à la mémoire système. Les indicateurs valides sont identiques aux indicateurs liés au bitblt utilisés avec le membre dwCKeyCaps .

dwSSBFXCaps

Fonctionnalités FX du pilote pour les bitblts de la mémoire système à la mémoire système. Les indicateurs valides sont identiques aux indicateurs liés au bitblt utilisés avec le membre dwFXCaps .

dwSSBRops[DD_ROP_SPACE]

Opérations raster prises en charge pour les bitblts de la mémoire système à la mémoire système.

dwReserved4

Réservé

dwReserved5

Réservé

dwReserved6

Réservé

Notes

À des fins de compatibilité descendante, le fichier d’en-tête Ddraw.h contient plusieurs définitions de la structure DDCAPS. La version qui passe le préprocesseur est déterminée par la valeur de la constante DIRECTDRAW_VERSION.

Spécifications

En-tête	ddraw.h