PFND3DDDI_SETDISPLAYMODE fonction de rappel (d3dumddi.h)

La fonction SetDisplayMode bascule vers un mode d’affichage ou un mode principal qui n’est pas pris en charge par le bureau GDI.

Syntaxe

PFND3DDDI_SETDISPLAYMODE Pfnd3dddiSetdisplaymode;

HRESULT Pfnd3dddiSetdisplaymode(
  HANDLE hDevice,
  const D3DDDIARG_SETDISPLAYMODE *unnamedParam2
)
{...}

Paramètres

hDevice

Handle de l’appareil d’affichage (contexte graphique).

unnamedParam2

pData [in]

Pointeur vers une structure D3DDDIARG_SETDISPLAYMODE qui spécifie les paramètres de définition du mode d’affichage.

Valeur de retour

SetDisplayMode retourne S_OK ou un résultat d’erreur approprié si le mode d’affichage n’est pas correctement défini.

Remarques

Le runtime Microsoft Direct3D appelle SetDisplayMode pour basculer vers un mode d’affichage ou principal qui n’est pas pris en charge par le bureau GDI. La liste suivante décrit des exemples de telles primaires :

  • Primaries créées avec des formats cibles de 10 bits par canal (10:10:10:2) d’affichage et de rendu cibles (par exemple, D3DFMT_A2R10G10B10)
  • Primaires à échantillonnage multiple où l’échantillonnage multiple est effectué lors de l’analyse
  • Principaux persistants utilisés par les applications Microsoft DirectX version 9.L en plein écran
Le runtime Direct3D appelle la fonction CreateResource du pilote d’affichage en mode utilisateur pour créer le réplica principal à analyser. Toutefois, le pilote doit programmer le matériel pour analyser uniquement lorsque sa fonction SetDisplayMode est appelée. Par conséquent, le runtime définit les membres hResource et SubResourceIndex de la structure D3DDDIARG_SETDISPLAYMODE pointés par le paramètre pData sur le principal créé via l’appel à la fonction CreateResource du pilote. Le pilote doit ensuite traduire le principal représenté par hResource et SubResourceIndex en handle d’allocation primaire. Une fois que le pilote a effectué cette traduction, le pilote doit passer le handle résultant dans un appel à la fonction pfnSetDisplayModeCb , qui lance ensuite un appel à la fonction DxgkDdiCommitVidPn du pilote DxgkDdiVidPn du pilote display.

Le pilote d’affichage en mode utilisateur peut définir le membre hPrimaryAllocation de la structure D3DDDICB_SETDISPLAYMODE dans l’appel à pfnSetDisplayModeCb pour analyser n’importe quelle allocation. Toutefois, l’allocation doit être marquée comme un principal (autrement dit, le pilote d’affichage en mode utilisateur doit avoir défini l’indicateur de champ bit principal dans le membre Flags de la structure D3DDDI_ALLOCATIONINFO dans un appel à la fonction pfnAllocateCb pour créer l’allocation).

Configuration requise

   
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dumddi.h (include D3dumddi.h)

Voir aussi

D3DDDIARG_SETDISPLAYMODE

D3DDDI_DEVICEFUNCS

pfnSetDisplayModeCb