Structure DDPIXELFORMAT (ksmedia.h)

La structure DDPIXELFORMAT décrit le format de pixel d’un objet DirectDrawSurface .

Syntaxe

typedef struct _DDPIXELFORMAT {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwFourCC;
  union {
    DWORD dwRGBBitCount;
    DWORD dwYUVBitCount;
    DWORD dwZBufferBitDepth;
    DWORD dwAlphaBitDepth;
  };
  union {
    DWORD dwRBitMask;
    DWORD dwYBitMask;
  };
  union {
    DWORD dwGBitMask;
    DWORD dwUBitMask;
  };
  union {
    DWORD dwBBitMask;
    DWORD dwVBitMask;
  };
  union {
    DWORD dwRGBAlphaBitMask;
    DWORD dwYUVAlphaBitMask;
    DWORD dwRGBZBitMask;
    DWORD dwYUVZBitMask;
  };
} DDPIXELFORMAT, *LPDDPIXELFORMAT;

Membres

dwSize

Spécifie la taille en octets de la structure DDPIXELFORMAT. Le pilote doit initialiser ce membre avant d’utiliser la structure.

DirectX 9.0 et versions ultérieures uniquement. Spécifie, lors de l’entrée, la version du runtime Microsoft DirectX utilisé par l’application. Ce membre est défini sur DD_RUNTIME_VERSION, ce qui est 0x00000900 pour DirectX 9.0, au format membre de la structure DD_GETFORMATDATA pour une requête D3DGDI2_TYPE_GETFORMAT.

dwFlags

Indique un ensemble d’indicateurs qui spécifient des indicateurs de contrôle facultatifs. Ce membre est un or au niveau du bit de l’une des valeurs suivantes :

dwFourCC

Spécifie un code de format surface incluant l’un des codes du type énuméré D3DFORMAT. Certains codes FOURCC font partie de D3DFORMAT. Pour plus d’informations sur D3DFORMAT, consultez la documentation du Kit de développement logiciel (SDK). Les fournisseurs de matériel peuvent également définir et fournir des codes de format spécifiques à leur matériel.

dwRGBBitCount

Spécifie le nombre de bits RVB par pixel (4, 8, 16, 24 ou 32).

dwYUVBitCount

Spécifie le nombre de bits YUV par pixel.

dwZBufferBitDepth

Spécifie la profondeur de bits de mémoire tampon Z (8, 16, 24 ou 32 bits).

dwAlphaBitDepth

Spécifie la profondeur de bits du canal Alpha.

dwRBitMask

Spécifie le masque pour les bits rouges.

dwYBitMask

Spécifie le masque pour les bits Y.

dwGBitMask

Spécifie le masque pour les bits verts.

dwUBitMask

Spécifie le masque pour les bits U.

dwBBitMask

Spécifie le masque pour les bits bleus.

dwVBitMask

Spécifie le masque pour les bits V.

dwRGBAlphaBitMask

Masque pour le canal alpha.

dwYUVAlphaBitMask

Masque pour le canal alpha.

dwRGBZBitMask

Masque pour le canal Z.

dwYUVZBitMask

Masque pour le canal Z.

Remarques

Le runtime DirectX 8.0 et ultérieur impose les règles suivantes à la liste des opérations (op) :

• Un seul endian-ness (grand ou petit) pour n’importe quel format DS est autorisé, par exemple D15S1 ou S1D15, non indépendant des autres bits.

• Une liste ne doit inclure D3DFORMAT_OP_DISPLAYMODE que pour un format 16bpp (par exemple, elle ne doit pas énumérer 5 :5 :5 et 5 :6 :5).

• Une liste ne doit pas contenir de formats alpha avec D3DFORMAT_OP_DISPLAYMODE ou D3DFORMAT_OP_3DACCELLERATION défini.

• L’indicateur D3DFORMAT_OP_3DACCELLERATION ne peut être défini que lorsque l’indicateur D3DFORMAT_OP_DISPLAYMODE est également défini.

Si le pilote prend en charge un D16 verrouillable, il doit signaler D3DFMT_D16_LOCKABLE dans la liste des opérations ; sinon, il devrait signaler D3DFMT_D16.

Les pilotes prenant en charge le multiéchantillonnage doivent remplir les MultiSampleCaps dans les formats profondeur/gabarit pour lesquels le multi-échantillonnage peut être pris en charge. Cela permet au runtime de détecter si un pilote prend en charge le multi-échantillonnage pour les combinaisons de formats cible de rendu et de mémoire tampon Z. Pour plus d’informations sur les restrictions liées à l’échantillonnage multiéchantillonnage étendu, consultez la description de D3DPRASTERCAPS_STRETCHBLTMULTISAMPLE limite dans les rastercaps contenues dans la structure D3DCAPS8 dans la documentation du Kit de développement logiciel (SDK).

Le type énuméré D3DMULTISAMPLE_TYPE défini dans d3d8types.h est utilisé lors de la définition des bits dans wFlipMSTypes et wBltMSTypes. Pour spécifier la prise en charge d’un nombre spécifique d’exemples par pixel, il suffit de déplacer logiquement 1 en fonction de la valeur appropriée à partir de l’D3DMULTISAMPLE_TYPE le type énuméré moins 1 et OR ceci dans le champ approprié (wFlipMSTypes et wBltMSTypes).

Par exemple, si le pilote prend en charge deux et quatre exemples par pixel lors du basculement (mode plein écran) et quatre exemples par pixel lors de la fente (mode fenêtré) sur X8R8G8B8 surface, l’entrée suivante est signalée dans la liste des formats de surface.

DDPIXELFORMAT ddpf;
ZeroMemory(&ddpf, sizeof(ddpf));
ddpf.dwSize       = sizeof(DDPIXELFORMAT);
ddpf.dwFlags      = DDPF_D3DFORMAT;
ddpf.dwFourCC     = D3DFMT_X8R8G8B8;
ddpf.dwOperations = D3DFORMAT_OP_DISPLAYMODE |
                    D3DFORMAT_OP_3DACCELERATION;
ddpf.MultiSampleCaps.wFlipMSTypes = (1 << (D3DMULTISAMPLE_4_SAMPLES âˆ' 1))
                                  | (1 << (D3DMULTISAMPLE_2_SAMPLES âˆ' 1));
ddpf.MultiSampleCaps.wBltMSTypes = (1 << (D3DMULTISAMPLE_4_SAMPLES âˆ' 1));

Il n’est pas nécessaire de spécifier 1 << (D3DMULTISAMPLE_NONE - 1) lors des formats de création de rapports. Il est supposé que n’importe quel format signalé peut également être utilisé sans multi-échantillonnage. Si le matériel prend en charge le rendu multi-échantillon avec une mémoire tampon z, les formats z-buffer signalés doivent également inclure les exemples pris en charge par pixels.

Configuration requise