PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB fonction de rappel (d3dumddi.h)

Article
02/26/2024

Insère un signal sur les objets de synchronisation spécifiés dans le flux d’accès direct à la mémoire (DMA) de contexte spécifié. Utilisé par les pilotes d’affichage en mode utilisateur WDDM 1.2 et versions ultérieures.

Syntaxe

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

HRESULT Pfnd3dddiSignalsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 *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_SIGNALSYNCHRONIZATIONOBJECT2 qui décrit les objets de synchronisation et le flux DMA de contexte sur lequel la signalisation est configurée.

Valeur retournée

Renvoie l'une des valeurs suivantes :

Code de retour	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 les membres hContext et BroadcastContext 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.Tapez = D3DDDI_FENCE), elles ne doivent être envoyées qu’une par une, et D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2. ObjectCount doit avoir la valeur 1.

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)