PFND3DDDI_CHECKCOUNTERINFO Rückruffunktion (d3dumddi.h)
Wird von der Microsoft Direct3D-Laufzeit aufgerufen, um globale Informationen zu bestimmen, die sich auf das Bearbeiten von Leistungsindikatoren beziehen. Muss von Windows Display Driver Model (WDDM) 1.3 und höher von Anzeigetreibern für den Benutzermodus 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 das Bearbeiten von Leistungsindikatoren beziehen.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion 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 Anzeigetreiber für den Benutzermodus keine Konzepte unterstützt, die in den Membern der D3DDDIARG_COUNTER_INFO-Struktur dargestellt werden, kann er die Elemente von D3DDDIARG_COUNTER_INFO mit Nullen auffüllen.
Die pfnCheckCounterInfo-Funktion des Treibers kann die pfnSetErrorCb Rückruffunktion nicht aufrufen, um den D3DDDIERR_DEVICEREMOVED Fehlercode festzulegen, da pfnCheckCounterInfo ein Funktionsüberprüfungstyp ist. Der Treiber muss sicherstellen, dass nach der Geräteerstellung genügend Informationen vorhanden sind, um auf einen Aufruf von pfnCheckCounterInfozu reagieren, auch wenn D3DDDIERR_DEVICEREMOVEDvorhanden ist. pfnCheckCounterInfo sollte keine Fehler auftreten. pfnCheckCounterInfo- kann jedoch pfnSetErrorCb- für kritische Fehler aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3d10umddi.h) |