PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Rückruffunktion (d3dumddi.h)

Artikel
02/26/2024

Fügt einen Wartebefehl für die angegebenen Synchronisierungsobjekte in den angegebenen Kontextbefehlsdatenstrom ein. Wird von Windows Display Driver Model (WDDM) 1.2 und höher für Benutzermodus-Anzeigetreiber verwendet.

Syntax

PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Pfnd3dddiWaitforsynchronizationobject2cb;

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

Parameter

hDevice

Ein Handle für ein Anzeigegerät (d. a. den Grafikkontext).

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2-Struktur , die die Synchronisierungsobjekte und den Kontext-DMA-Stream beschreibt, die zum Einrichten des Wartevorgangs erforderlich sind.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Die Wartedauer wurde erfolgreich eingerichtet.
E_INVALIDARG	Die Parameter wurden überprüft und als falsch ermittelt.

Diese Funktion gibt möglicherweise auch andere HRESULT-Werte zurück.

Hinweise

Die pfnCreateSynchronizationObject2Cb-Funktion gibt ein Kernelmodushandle an das neu erstellte Synchronisierungsobjekt im hSyncObject-Member der D3DDDICB_CREATESYNCHRONIZATIONOBJECT2-Struktur zurück, auf die der pData-Parameter verweist. Der Anzeigetreiber für den Benutzermodus übergibt dieses Handle in Aufrufen der folgenden Funktionen:

Rufen Sie diese Funktion nicht auf, wenn das Synchronisierungsobjekt vom Typ D3DDDI_CPU_NOTIFICATION ist. Das Type-Element der D3DDDI_SYNCHRONIZATIONOBJECTINFO2-Struktur weist den Wert D3DDDI_CPU_NOTIFICATION auf. pfnDestroySynchronizationObjectCb

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)