Compartilhar via

Método IDebugDataSpaces::ReadProcessorSystemData (dbgeng.h)

  • Artigo

O método ReadProcessorSystemData retorna dados sobre o processador especificado.

Sintaxe

HRESULT ReadProcessorSystemData(
  [in]            ULONG  Processor,
  [in]            ULONG  Index,
  [out]           PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG DataSize
);

Parâmetros

[in] Processor

Especifica o processador cujos dados devem ser lidos.

[in] Index

Especifica o tipo de dados a ser lido. A tabela a seguir contém os valores válidos. Após a conclusão bem-sucedida, os dados retornados no Buffer de buffer têm o tipo especificado pela coluna intermediária.

Valor Descrição
DEBUG_DATA_KPCR_OFFSET Retorna o endereço virtual da PCR (Região de Controle do Processador) do processador.

Nesse caso, o buffer de argumento pode ser considerado com o tipo PULONG64.
DEBUG_DATA_KPRCB_OFFSET Retorna o endereço virtual do PRCB (Bloco de Controle do Processador) do processador.

Nesse caso, o buffer de argumento pode ser considerado com o tipo PULONG64.
DEBUG_DATA_KTHREAD_OFFSET Retorna o endereço virtual da estrutura KTHREAD para o thread do sistema em execução no processador.

Nesse caso, o buffer de argumento pode ser considerado com o tipo PULONG64.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET Retorna o endereço virtual da base das informações de paginação pertencentes ao sistema operacional ou ao processador. O endereço e o conteúdo no endereço são dependentes do processador e do sistema operacional.

Nesse caso, o buffer de argumento pode ser considerado com o tipo PULONG64.
DEBUG_DATA_PROCESSOR_IDENTIFICATION Retorna uma descrição do processador.

Nesse caso, o buffer de argumento pode ser considerado como tendo o tipo PDEBUG_PROCESSOR_IDENTIFICATION_ALL .
DEBUG_DATA_PROCESSOR_SPEED Retorna a velocidade do processador em MHz. Isso pode não funcionar em uma sessão específica.

Nesse caso, o argumento Buffer pode ser considerado como tendo o tipo PULONG.

[out] Buffer

Recebe os dados do processador. Após a conclusão bem-sucedida do método, o conteúdo desse buffer pode ser acessado convertendo Buffer no tipo especificado na tabela acima.

[in] BufferSize

Especifica o tamanho em bytes do Buffer de buffer. Esse é o número máximo de bytes que serão retornados.

[out, optional] DataSize

Recebe o tamanho dos dados em bytes. Se DataSize for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
 

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

Esse método só está disponível na depuração no modo kernel.

Para obter informações sobre as estruturas PCR, PRCB e KTHREAD, bem como informações sobre tabelas de paginação, consulte Microsoft Windows Internals de David Solomon e Mark Russinovich.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)