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) |