PFND3DDDI_SETDISPLAYMODE fonction de rappel (d3dumddi.h)

Article
02/26/2024

La fonction SetDisplayMode bascule vers un mode d’affichage ou 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 pour le périphérique d’affichage (contexte graphique).

unnamedParam2

pData [in]

Pointeur vers une structure de D3DDDIARG_SETDISPLAYMODE qui spécifie des paramètres pour définir le mode d’affichage.

Valeur retournée

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 ces primaires :

Les primitives créées avec 10 bits par canal (10 :10 :10 :2) affichent et affichent les formats cibles de rendu (par exemple, D3DFMT_A2R10G10B10)
Primaires à échantillonnage multiple où l’échantillonnage multiple est effectué lors de l’analyse
Primaires persistantes utilisées 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 principal à analyser. Toutefois, le pilote doit programmer le matériel pour qu’il analyse 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ée par le paramètre pData vers la base de données primaire créée 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 de miniport d’affichage.

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

Configuration requise

Condition requise	Valeur
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 (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_SETDISPLAYMODE

D3DDDI_DEVICEFUNCS

pfnSetDisplayModeCb

Partager via