PFND3D10DDI_CHECKCOUNTER função de retorno de chamada (d3d10umddi.h)
A função CheckCounter recupera informações que descrevem um contador.
Sintaxe
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]
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
Consulta [in]
Um valor do tipo D3D10DDI_QUERY que identifica o identificador do contador para o qual as informações são recuperadas.
unnamedParam3
pCounterType [out]
Um ponteiro para uma variável que recebe um dos seguintes valores da enumeração D3D10DDI_COUNTER_TYPE que identifica o tipo de dados que o contador gera.
| Valor | Significado |
|---|---|
| D3D10DDI_COUNTER_TYPE_FLOAT32 | Float de precisão ú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]
Um ponteiro para o qual o driver retorna uma cadeia de caracteres terminada em NULL que contém a descrição do que o identificador de contador mede.
unnamedParam5
pActiveCounters [out]
Um ponteiro para uma variável que recebe o número de contadores ativos simultaneamente alocados para a criação do identificador de contador que a Consulta identifica.
[in, out] pNameLength
Um ponteiro para uma variável que recebe o tamanho, em bytes, da cadeia de caracteres terminada em NULL especificada pelo parâmetro pName .
unnamedParam7
pName [out]
Um ponteiro para o qual o driver retorna uma cadeia de caracteres terminada em NULL que contém o nome do identificador do contador.
[in, out] pUnitsLength
Um ponteiro para uma variável que recebe o tamanho, em bytes, da cadeia de caracteres terminada em NULL especificada pelo parâmetro pUnits .
unnamedParam9
pUnits [out]
Um ponteiro para o qual o driver retorna uma cadeia de caracteres terminada em NULL que contém o nome das unidades que o identificador de contador mede.
[in, out] pDescriptionLength
Um ponteiro para uma variável que recebe o tamanho, em bytes, da cadeia de caracteres terminada em NULL especificada pelo parâmetro pDescription .
Retornar valor
Nenhum
Comentários
O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro.
A função CheckCounter do driver pode chamar a função de retorno de chamada pfnSetErrorCb para definir o código de erro ERR_UNSUPPORTED se o parâmetro Query de CheckCounterespecificar um contador conhecido que o dispositivo não dá suporte.
O driver deve validar um identificador de contador dependente do dispositivo para garantir que o identificador esteja dentro do intervalo. O driver também deve garantir que exista espaço suficiente para copiar cada cadeia de caracteres de contador em cada buffer fornecido pelo runtime do Microsoft Direct3D. O driver pode chamar a função de retorno de chamada pfnSetErrorCb para definir o código de erro E_INVALIDARG se não houver espaço suficiente para nenhum dos buffers fornecidos.
A função CheckCounter do driver não pode chamar a função de retorno de chamada pfnSetErrorCb para definir o código de erro D3DDDIERR_DEVICEREMOVED porque CheckCounter é um tipo de função marcar funcionalidade. O driver deve garantir que ele tenha informações suficientes após a criação do dispositivo para responder a uma chamada para CheckCounter, mesmo na presença de D3DDDIERR_DEVICEREMOVED.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3d10umddi.h (inclua D3d10umddi.h) |