PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB fonction de rappel (d3dumddi.h)

Article
02/26/2024

Insère une commande d’attente pour les objets de synchronisation spécifiés dans le flux de commande de contexte spécifié. Utilisé par les pilotes d’affichage en mode utilisateur windows WDDM (Windows Display Driver Model) 1.2 et versions ultérieures.

Syntaxe

PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Pfnd3dddiWaitforsynchronizationobject2cb;

HRESULT Pfnd3dddiWaitforsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Paramètres

hDevice

Handle sur un périphérique d’affichage (c’est-à-dire le contexte graphique).

unnamedParam2

pData [in]

Pointeur vers une structure de D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 qui décrit les objets de synchronisation et le flux DMA de contexte requis pour configurer l’attente.

Valeur retournée

Renvoie l'une des valeurs suivantes :

Code de retour	Description
S_OK	L’attente a été correctement configurée.
E_INVALIDARG	Les paramètres ont été validés et déterminés comme incorrects.

Cette fonction peut également retourner d’autres valeurs HRESULT.

Remarques

La fonction pfnCreateSynchronizationObject2Cb retourne un handle en mode noyau à l’objet de synchronisation nouvellement créé dans le membre hSyncObject de la structure D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 vers laquelle pointe le paramètre pData . Le pilote d’affichage en mode utilisateur transmet ce handle dans les appels aux fonctions suivantes :

N’appelez pas cette fonction si l’objet de synchronisation est de type D3DDDI_CPU_NOTIFICATION, à savoir que le membre Type de la structure D3DDDI_SYNCHRONIZATIONOBJECTINFO2 a une valeur de D3DDDI_CPU_NOTIFICATION. pfnDestroySynchronizationObjectCb

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dumddi.h (inclure D3dumddi.h)