PFND3D10DDI_CHECKCOUNTER función de devolución de llamada (d3d10umddi.h)

La función CheckCounter recupera información que describe un contador.

Sintaxis

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
)
{...}

Parámetros

unnamedParam1

hDevice [in]

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

Consulta [in]

Valor con tipo D3D10DDI_QUERY que identifica el identificador de contador para el que se recupera la información.

unnamedParam3

pCounterType [out]

Puntero a una variable que recibe uno de los siguientes valores de la enumeración D3D10DDI_COUNTER_TYPE que identifica el tipo de datos que genera el contador.

Valor	Significado
D3D10DDI_COUNTER_TYPE_FLOAT32	Float de precisión única
D3D10DDI_COUNTER_TYPE_UINT16	Valor de 16 bits
D3D10DDI_COUNTER_TYPE_UINT32	Valor de 32 bits
D3D10DDI_COUNTER_TYPE_UINT64	Valor de 64 bits

unnamedParam4

pDescription [out]

Puntero al que el controlador devuelve una cadena terminada en NULL que contiene la descripción de lo que mide el identificador de contador.

unnamedParam5

pActiveCounters [out]

Puntero a una variable que recibe el número de contadores activos simultáneamente asignados para la creación del identificador de contador que identifica Query .

[in, out] pNameLength

Puntero a una variable que recibe el tamaño, en bytes, de la cadena terminada en NULL que especifica el parámetro pName .

unnamedParam7

pName [out]

Puntero al que el controlador devuelve una cadena terminada en NULL que contiene el nombre del identificador del contador.

[in, out] pUnitsLength

Puntero a una variable que recibe el tamaño, en bytes, de la cadena terminada en NULL que especifica el parámetro pUnits .

unnamedParam9

pUnits [out]

Puntero al que el controlador devuelve una cadena terminada en NULL que contiene el nombre de las unidades que mide el identificador de contador.

[in, out] pDescriptionLength

Puntero a una variable que recibe el tamaño, en bytes, de la cadena terminada en NULL que especifica el parámetro pDescription .

Valor devuelto

None

Observaciones

El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.

La función CheckCounter del controlador puede llamar a la función de devolución de llamada pfnSetErrorCb para establecer el código de error ERR_UNSUPPORTED si el parámetro Query de CheckCounterespecifica un contador conocido que el dispositivo no admite.

El controlador debe validar un identificador de contador dependiente del dispositivo para asegurarse de que el identificador está dentro del intervalo. El controlador también debe asegurarse de que exista espacio suficiente para copiar cada cadena de contador en cada búfer que proporciona el tiempo de ejecución de Microsoft Direct3D. El controlador puede llamar a la función de devolución de llamada pfnSetErrorCb para establecer el código de error E_INVALIDARG si no hay suficiente espacio para cualquiera de los búferes proporcionados.

La función CheckCounter del controlador no puede llamar a la función de devolución de llamada pfnSetErrorCb para establecer el código de error D3DDDIERR_DEVICEREMOVED porque CheckCounter es un tipo de función de comprobación de funcionalidad. El controlador debe asegurarse de que tiene suficiente información después de la creación del dispositivo para responder a una llamada a CheckCounter, incluso en presencia de D3DDDIERR_DEVICEREMOVED.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3d10umddi.h (incluya D3d10umddi.h)

Consulte también

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb