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

Artigo
02/06/2025

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 buffer tem 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 argumento o buffer pode ser considerado com PULONG64 de tipo.
DEBUG_DATA_KPRCB_OFFSET	Retorna o endereço virtual do PRCB (Bloco de Controle do Processador) do processador. Nesse caso, o argumento o buffer pode ser considerado com PULONG64 de tipo.
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 argumento o buffer pode ser considerado com PULONG64 de tipo.
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 dependem do processador e do sistema operacional. Nesse caso, o argumento o buffer pode ser considerado com PULONG64 de tipo.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Retorna uma descrição do processador. Nesse caso, o argumento buffer pode ser considerado como ter PDEBUG_PROCESSOR_IDENTIFICATION_ALL de tipo.
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 sendo do 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 pela conversão buffer para o tipo especificado na tabela acima.

[in] BufferSize

Especifica o tamanho em bytes do buffer 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.

Valor de retorno

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 de Valores Retornados para obter mais detalhes.

Observações

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 por David Solomon e Mark Russinovich.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Compartilhar via