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

Weitere Informationen

ID3D11Device