ID3D11Device::CheckCounter-Methode (d3d11.h)
Rufen Sie den Typ, den Namen, die Maßeinheiten und eine Beschreibung eines vorhandenen Indikators ab.
Syntax
HRESULT CheckCounter(
[in] const D3D11_COUNTER_DESC *pDesc,
[out] D3D11_COUNTER_TYPE *pType,
[out] UINT *pActiveCounters,
[out, optional] LPSTR szName,
[in, out, optional] UINT *pNameLength,
[out, optional] LPSTR szUnits,
[in, out, optional] UINT *pUnitsLength,
[out, optional] LPSTR szDescription,
[in, out, optional] UINT *pDescriptionLength
);
Parameter
[in] pDesc
Typ: const D3D11_COUNTER_DESC*
Zeiger auf eine Zählerbeschreibung (siehe D3D11_COUNTER_DESC). Gibt an, über welche Indikatorinformationen abgerufen werden sollen.
[out] pType
Typ: D3D11_COUNTER_TYPE*
Zeiger auf den Datentyp eines Zählers (siehe D3D11_COUNTER_TYPE). Gibt den Datentyp des abzurufenden Indikators an.
[out] pActiveCounters
Typ: UINT*
Zeiger auf die Anzahl der Hardwareindikatoren, die für die Erstellung dieses Leistungsindikatortyps erforderlich sind. Alle Instanzen desselben Leistungsindikatortyps verwenden die gleichen Hardwareindikatoren.
[out, optional] szName
Typ: LPSTR
Zeichenfolge, die mit einem kurzen Namen für den Leistungsindikator gefüllt werden soll. Kann NULL sein, wenn die Anwendung nicht am Namen des Indikators interessiert ist.
[in, out, optional] pNameLength
Typ: UINT*
Länge der an szName zurückgegebenen Zeichenfolge. Kann NULL sein.
[out, optional] szUnits
Typ: LPSTR
Name der Einheiten, die ein Zähler misst, vorausgesetzt, der Speicher, auf den der Zeiger verweist, verfügt über genügend Platz, um die Zeichenfolge zu speichern. Kann NULL sein. Die zurückgegebene Zeichenfolge ist immer in Englisch.
[in, out, optional] pUnitsLength
Typ: UINT*
Länge der an szUnits zurückgegebenen Zeichenfolge. Kann NULL sein.
[out, optional] szDescription
Typ: LPSTR
Eine Beschreibung des Leistungsindikators, sofern der Speicher, auf den der Zeiger verweist, über genügend Platz verfügt, um die Zeichenfolge zu speichern. Kann NULL sein. Die zurückgegebene Zeichenfolge ist immer in Englisch.
[in, out, optional] pDescriptionLength
Typ: UINT*
Länge der an szDescription zurückgegebenen Zeichenfolge. Kann NULL sein.
Rückgabewert
Typ: HRESULT
Diese Methode gibt einen der folgenden Direct3D 11-Rückgabecodes zurück.
Hinweise
Längenparameter können NULL sein, was angibt, dass die Anwendung weder an der Länge noch an dem entsprechenden Zeichenfolgenwert interessiert ist. Wenn ein length-Parameter ungleich NULL ist und die entsprechende Zeichenfolge NULL ist, wird der Eingabewert des length-Parameters ignoriert, und die Länge der entsprechenden Zeichenfolge (einschließlich der Beendigung von NULL) wird durch den length-Parameter zurückgegeben. Wenn länge und der entsprechende Parameter beide ungleich NULL sind, wird der Eingabewert der Länge überprüft, um sicherzustellen, dass genügend Platz vorhanden ist, und dann wird die Länge der Zeichenfolge (einschließlich des abschließenden NULL-Zeichens ) über den length-Parameter übergeben.
Windows Phone 8: Diese API wird unterstützt.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d11.h |
| Bibliothek | D3D11.lib |