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) |