PFND3D10DDI_CHECKCOUNTER Rückruffunktion (d3d10umddi.h)

Die CheckCounter-Funktion ruft Informationen ab, die einen Leistungsindikator 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 typisierter Wert, der den Indikatorbezeichner identifiziert, für den Die 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.

unnamedParam4

pDescription [out]

Ein Zeiger, an den der Treiber eine NULL-beendete Zeichenfolge zurückgibt, die die Beschreibung der Vom Indikatorbezeichner erfassten Werte enthält.

unnamedParam5

pActiveCounters [out]

Ein Zeiger auf eine Variable, die die Anzahl der gleichzeitig aktiven Leistungsindikatoren empfängt, die für die Erstellung des von Query identifizierten Indikatorbezeichners zugeordnet sind.

[in, out] pNameLength

Ein Zeiger auf eine Variable, die die Größe der mit NULL beendeten Zeichenfolge in Bytes empfängt, die der pName-Parameter angibt.

unnamedParam7

pName [out]

Ein Zeiger, an den der Treiber eine NULL-beendete Zeichenfolge zurückgibt, die den Namen des Indikatorbezeichners 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, an den der Treiber eine NULL-beendete Zeichenfolge zurückgibt, die den Namen der Einheiten enthält, die der Indikatorbezeichner misst.

[in, out] pDescriptionLength

Ein Zeiger auf eine Variable, die die Größe der MIT NULL beendeten Zeichenfolge in Byte empfängt, die der pDescription-Parameter angibt.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.

Die CheckCounter-Funktion des Treibers kann die PfnSetErrorCb-Rückruffunktion aufrufen, um den ERR_UNSUPPORTED Fehlercode festzulegen, wenn der Abfrageparameter von CheckCountereinen bekannten Leistungsindikator angibt, der vom Gerät nicht unterstützt wird.

Der Treiber muss einen geräteabhängigen Zählerbezeichner überprüfen, um sicherzustellen, dass der Bezeichner innerhalb des Bereichs liegt. Der Treiber muss auch sicherstellen, dass genügend Speicherplatz vorhanden ist, um jede Zählerzeichenfolge in jeden Puffer zu kopieren, den die Microsoft Direct3D-Runtime bereitstellt. Der Treiber kann die PfnSetErrorCb-Rückruffunktion aufrufen, um den E_INVALIDARG Fehlercode festzulegen, wenn nicht genügend Speicherplatz für einen der bereitgestellten Puffer 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 er nach der Geräteerstellung über genügend Informationen verfügt, um auf einen Aufruf von CheckCounter zu reagieren, auch wenn D3DDDIERR_DEVICEREMOVED vorhanden ist.

Anforderungen

Weitere Informationen

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb