PFND3DDDI_GETQUERYDATA Rückruffunktion (d3dumddi.h)

Die GetQueryData-Funktion ruft Informationen zu einer Abfrage ab.

Syntax

PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;

HRESULT Pfnd3dddiGetquerydata(
  HANDLE hDevice,
  const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [ein, aus]

Ein Zeiger auf eine D3DDDIARG_GETQUERYDATA-Struktur , die die Informationen zur Abfrage enthält, die vom Treiber abgerufen wird.

Rückgabewert

GetQueryData gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Der Abfragevorgang wurde abgeschlossen, und das Abfrageergebnis ist verfügbar.
S_FALSE	GetQueryData wurde erfolgreich zurückgegeben. Der Abfragevorgang wurde jedoch nicht abgeschlossen, sodass das Abfrageergebnis nicht verfügbar ist.
E_OUTOFMEMORY	GetQueryData konnte den erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

Die Microsoft Direct3D-Runtime kann GetQueryData jederzeit aufrufen, nachdem die IssueQuery-Funktion des Benutzermodusanzeigetreibers aufgerufen wurde. Der Benutzermodusanzeigetreiber sollte den aktuellen Zaunwert anhand des Werts überprüfen, der in der privaten Abfragestruktur des Treibers gespeichert ist, um zu ermitteln, ob das Abfrageproblem abgeschlossen ist.

Wenn die Abfrage abgeschlossen ist, sollte der Treiber S_OK zurückgeben. Andernfalls sollte der Treiber S_FALSE zurückgeben.

Wenn ein Treiber Optimierungen mit mehreren Prozessoren mit Laufzeitverarbeitung unterstützt und eine DDI-Version von 0x0000000B oder höher verfügbar macht, ruft die Runtime GetQueryData erneut auf. Der Treiber gibt den Wert DDI-version im DriverVersion-Member der D3D10DDIARG_OPENADAPTER-Struktur in einem Aufruf der OpenAdapter-Funktion des Treibers zurück. Wenn die Runtime GetQueryData erneut aufruft, kann ein Thread in GetQueryData ausgeführt werden, während ein anderer Thread, der auf dasselbe Anzeigegerät verweist, innerhalb einer anderen Anzeigetreiberfunktion im Benutzermodus ausgeführt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDIARG_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery