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)

Confira também

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb