Méthode IDirect3D9ExOverlayExtension ::CheckDeviceOverlayType (d3d9.h)

  • Article

Interroge les fonctionnalités matérielles de superposition d’un appareil Direct3D.

Syntaxe

HRESULT CheckDeviceOverlayType(
  [in]  UINT               Adapter,
  [in]  D3DDEVTYPE         DevType,
  [in]  UINT               OverlayWidth,
  [in]  UINT               OverlayHeight,
  [in]  D3DFORMAT          OverlayFormat,
  [in]  D3DDISPLAYMODEEX   *pDisplayMode,
  [in]  D3DDISPLAYROTATION DisplayRotation,
  [out] D3DOVERLAYCAPS     *pOverlayCaps
);

Paramètres

[in] Adapter

Nombre ordinal qui désigne l’adaptateur d’affichage. D3DADAPTER_DEFAULT est toujours la carte d’affichage principale.

[in] DevType

Spécifie le type d’appareil Direct3D en tant que membre du D3DDEVTYPE type énuméré.

[in] OverlayWidth

Largeur de la superposition à créer, en pixels.

[in] OverlayHeight

Hauteur de la superposition à créer, en pixels.

[in] OverlayFormat

Format de surface de la superposition.

[in] pDisplayMode

Pointeur vers une structure de D3DDISPLAYMODEEX qui spécifie le mode d’affichage à utiliser. Si ce paramètre a la valeur NULL, le mode d’affichage actuel est supposé.

[in] DisplayRotation

Spécifie le mode de rotation d’affichage en tant que membre du type énuméré D3DDISPLAYROTATION .

[out] pOverlayCaps

Pointeur vers une structure D3DOVERLAYCAPS . Si le pilote prend en charge les paramètres de superposition spécifiés dans les paramètres d’entrée, la méthode remplit cette structure avec les fonctionnalités du matériel de superposition.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
D3DERR_INVALIDCALL
 Paramètre non valide ou l’appareil ne prend pas en charge la superposition matérielle.
D3DERR_UNSUPPORTEDOVERLAY
 L’appareil ne prend pas en charge la superposition pour la taille ou le mode d’affichage spécifiés.
D3DERR_UNSUPPORTEDOVERLAYFORMAT
 L’appareil ne prend pas en charge la superposition pour le format de surface spécifié.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête d3d9.h

Voir aussi

Prise en charge de la superposition matérielle

IDirect3D9ExOverlayExtension