PFND3D10DDI_CHECKCOUNTER Rückruffunktion (d3d10umddi.h)
Die CheckCounter--Funktion ruft Informationen ab, die einen Zähler beschreiben.
Syntax
PFND3D10DDI_CHECKCOUNTER Pfnd3d10ddiCheckcounter;
void Pfnd3d10ddiCheckcounter(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_QUERY unnamedParam2,
D3D10DDI_COUNTER_TYPE *unnamedParam3,
UINT *unnamedParam4,
LPSTR unnamedParam5,
[in, out] UINT *pNameLength,
LPSTR unnamedParam7,
[in, out] UINT *pUnitsLength,
LPSTR unnamedParam9,
[in, out] UINT *pDescriptionLength
)
{...}
Parameter
unnamedParam1
hDevice [in]
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
Abfrage- [in]
Ein D3D10DDI_QUERY-typed-Wert, der den Zählerbezeichner identifiziert, für den Informationen abgerufen werden.
unnamedParam3
pCounterType [out]
Ein Zeiger auf eine Variable, die einen der folgenden Werte aus der D3D10DDI_COUNTER_TYPE Enumeration empfängt, die den Datentyp identifiziert, den der Zähler ausgibt.
| Wert | Bedeutung |
|---|---|
| D3D10DDI_COUNTER_TYPE_FLOAT32 | Gleitkomma mit einfacher Genauigkeit |
| D3D10DDI_COUNTER_TYPE_UINT16 | 16-Bit-Wert |
| D3D10DDI_COUNTER_TYPE_UINT32 | 32-Bit-Wert |
| D3D10DDI_COUNTER_TYPE_UINT64 | 64-Bit-Wert |
unnamedParam4
pDescription- [out]
Ein Zeiger, an den der Treiber eine NULL-beendete Zeichenfolge zurückgibt, die die Beschreibung enthält, was der Indikatorbezeichner misst.
unnamedParam5
pActiveCounters [out]
Ein Zeiger auf eine Variable, die die Anzahl gleichzeitig aktiver Leistungsindikatoren empfängt, die für die Erstellung des Zählerbezeichners zugeordnet sind, der Abfrage- identifiziert.
[in, out] pNameLength
Ein Zeiger auf eine Variable, die die Größe der NULL-beendeten Zeichenfolge in Byte empfängt, die der pName Parameter angibt.
unnamedParam7
pName- [out]
Ein Zeiger, auf den der Treiber eine NULL-beendete Zeichenfolge zurückgibt, die den Namen des Zählerbezeichners enthält.
[in, out] pUnitsLength
Ein Zeiger auf eine Variable, die die Größe der NULL-beendeten Zeichenfolge in Byte empfängt, die der pUnits-Parameter angibt.
unnamedParam9
pUnits [out]
Ein Zeiger, auf den der Treiber eine NULL-beendete Zeichenfolge zurückgibt, die den Namen der Einheiten enthält, die der Zählerbezeichner misst.
[in, out] pDescriptionLength
Ein Zeiger auf eine Variable, die die Größe der NULL-beendeten Zeichenfolge in Byte empfängt, die der pDescription--Parameter angibt.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.
Die CheckCounter--Funktion des Treibers kann die pfnSetErrorCb Rückruffunktion aufrufen, um den ERR_UNSUPPORTED Fehlercode festzulegen, wenn der parameter Query von CheckCountereinen bekannten Zähler angibt, den das Gerät nicht unterstützt.
Der Treiber muss einen geräteabhängigen Zählerbezeichner überprüfen, um sicherzustellen, dass sich der Bezeichner innerhalb des Bereichs befindet. Der Treiber muss auch sicherstellen, dass genügend Speicherplatz vorhanden ist, um jede Zählerzeichenfolge in jeden Puffer zu kopieren, den die Microsoft Direct3D-Laufzeit bereitstellt. Der Treiber kann die pfnSetErrorCb Rückruffunktion aufrufen, um den E_INVALIDARG Fehlercode festzulegen, wenn für einen der bereitgestellten Puffer nicht genügend Speicherplatz vorhanden ist.
Die CheckCounter-Funktion des Treibers kann die pfnSetErrorCb- Rückruffunktion nicht aufrufen, um den D3DDDIERR_DEVICEREMOVED Fehlercode festzulegen, da CheckCounter- ein Funktionsüberprüfungstyp ist. Der Treiber muss sicherstellen, dass nach der Geräteerstellung genügend Informationen vorhanden sind, um auf einen Aufruf von CheckCounterzu reagieren, auch wenn D3DDDIERR_DEVICEREMOVED vorhanden sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |