PFND3DDDI_CHECKCOUNTERINFO Rückruffunktion (d3dumddi.h)
Wird von der Microsoft Direct3D-Runtime aufgerufen, um globale Informationen zu ermitteln, die sich auf die Bearbeitung von Leistungsindikatoren beziehen. Muss von Windows Display Driver Model (WDDM) 1.3 und höher für Benutzermodusanzeigetreiber implementiert werden.
Syntax
PFND3DDDI_CHECKCOUNTERINFO Pfnd3dddiCheckcounterinfo;
void Pfnd3dddiCheckcounterinfo(
HANDLE hDevice,
D3DDDIARG_COUNTER_INFO *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pCounterInfo [out]
Ein Zeiger auf eine D3DDDIARG_COUNTER_INFO Struktur, die der Treiber mit globalen Informationen auffüllt, die sich auf die Bearbeitung von Leistungsindikatoren beziehen.
Rückgabewert
Keine
Bemerkungen
Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen. Weitere Informationen zum Festlegen von Fehlercodes finden Sie im folgenden Abschnitt Hinweise.
Diese Funktion sollte sich ähnlich wie die CheckCounterInfo-Funktion verhalten, die Microsoft Direct3D 10 und höher unterstützt.
Wenn der Benutzermodusanzeigetreiber keines der Konzepte unterstützt, die in den Membern der D3DDDIARG_COUNTER_INFO-Struktur dargestellt werden, kann er die Member von D3DDDIARG_COUNTER_INFO mit Nullen auffüllen.
Die pfnCheckCounterInfo-Funktion des Treibers kann die Rückruffunktion pfnSetErrorCb nicht aufrufen, um den D3DDDIERR_DEVICEREMOVED Fehlercode festzulegen, da pfnCheckCounterInfo ein Funktionstyp der Funktionsprüfung ist. Der Treiber muss sicherstellen, dass er nach der Geräteerstellung über genügend Informationen verfügt, um auf einen Aufruf von pfnCheckCounterInfo zu reagieren, auch wenn D3DDDIERR_DEVICEREMOVED vorhanden ist. pfnCheckCounterInfo sollte keine Fehler aufweisen. PfnCheckCounterInfo kann jedoch pfnSetErrorCb bei kritischen Fehlern aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (einschließlich D3d10umddi.h) |