PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB fonction de rappel (d3dumddi.h)

Article
02/06/2025

Insère un signal sur les objets de synchronisation spécifiés dans le flux DMA (Context Direct Memory Access) spécifié. Utilisé par WDDM 1.2 et les pilotes d’affichage en mode utilisateur ultérieur.

Syntaxe

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

HRESULT Pfnd3dddiSignalsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Paramètres

hDevice

Handle vers un appareil d’affichage (autrement dit, le contexte graphique).

unnamedParam2

pData [in]

Pointeur vers une structure D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 qui décrit les objets de synchronisation et le flux DMA de contexte sur lequel la signalisation est configurée.

Valeur de retour

Retourne l’une des valeurs suivantes :

Retourner le code	Description
S_OK	La signalisation 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 :

La fonction pfnSignalSynchronizationObject2Cb envoie une commande de signal au flux de commandes de tous les contextes Microsoft Direct3D spécifiés par l'hContext et BroadcastContext membres de la structure D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2. Les objets de synchronisation sont signalés uniquement lorsque toutes les commandes de signal envoyées sont traitées.

Si les objets de synchronisation sont de type D3DDDI_FENCE (où D3DDDI_SYNCHRONIZATIONOBJECTINFO2.Type = D3DDDI_FENCE), ils ne doivent être soumis qu’un seul à la fois et D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2.ObjectCount doit avoir la valeur 1.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Bureau
d’en-tête	d3dumddi.h (include D3dumddi.h)

Voir aussi

D3DDDICB_CREATESYNCHRONIZATIONOBJECT2

D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2

pfnCreateSynchronizationObject2Cb

pfnDestroySynchronizationObjectCb

pfnWaitForSynchronizationObject2Cb

Partager via