PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Rückruffunktion (d3dumddi.h)

Artikel
02/06/2025

Fügt einen Wartebefehl für die angegebenen Synchronisierungsobjekte im angegebenen Kontextbefehlsstream ein. Wird von Windows Display Driver Model (WDDM) 1.2 und höher angezeigten Treibern für den Benutzermodus 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 DMA-Kontextdatenstrom beschreibt, die zum Einrichten der Wartezeit erforderlich sind.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Die Wartezeit wurde erfolgreich eingerichtet.
E_INVALIDARG	Parameter wurden überprüft und ermittelt, dass sie falsch sind.

Diese Funktion kann auch andere HRESULT-Werte zurückgeben.

Bemerkungen

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_NOTIFICATIONist, nämlich das Type Member der D3DDDI_SYNCHRONIZATIONOBJECTINFO2-Struktur einen Wert von D3DDDI_CPU_NOTIFICATIONhat.pfnDestroySynchronizationObjectCb

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Desktop
Header-	d3dumddi.h (include D3dumddi.h)