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- [in, out]
Ein Zeiger auf eine D3DDDIARG_GETQUERYDATA Struktur, die die Informationen zu der 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, damit er abgeschlossen werden kann. |
Bemerkungen
Die Microsoft Direct3D-Laufzeit kann GetQueryData- jederzeit aufrufen, nachdem die IssueQuery-Funktion des Benutzermodusanzeigetreibers aufgerufen wurde. Der Anzeigetreiber für den Benutzermodus sollte den aktuellen Zaunwert anhand des Werts überprüfen, der in der privaten Abfragestruktur des Treibers gespeichert ist, um festzustellen, 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 laufzeitgesteuerte Mehrfachprozessoroptimierungen unterstützt und eine DDI-Version von 0x0000000B oder höher verfügbar macht, ruft die Laufzeit GetQueryData- erneut auf. Der Treiber gibt den DDI-Versionswert im DriverVersion Member der D3D10DDIARG_OPENADAPTER-Struktur in einem Aufruf der OpenAdapter-Funktion des Treibers zurück. Wenn die Laufzeit GetQueryData- erneut aufruft, kann ein Thread innerhalb GetQueryData- ausgeführt werden, während ein anderer Thread, der auf dasselbe Anzeigegerät verweist, innerhalb einer anderen Benutzermodusanzeigetreiberfunktion ausgeführt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |