Função ReadControlSpace64 (wdbgexts.h)

A função ReadControlSpace64 lê o espaço de controle específico do processador na matriz apontada por buf.

Sintaxe

void ReadControlSpace64(
  USHORT  processor,
  ULONG64 address,
  PVOID   buf,
  ULONG   size
);

Parâmetros

processor

Especifica o número do processador cujo espaço de controle deve ser lido.

address

Especifica o endereço do espaço de controle.

buf

Especifica o endereço de uma matriz de bytes para manter os dados de espaço de controle.

size

Especifica o número de bytes na matriz apontada por buf.

Valor de retorno

Nenhum

Observações

Se você estiver escrevendo um código de 32 bits, deverá usar ReadControlSpace. Consulte ponteiros de 32 bits e ponteiros de 64 bits para obter detalhes.

Se você estiver escrevendo uma extensão WdbgExts, inclua wdbgexts.h. Se você estiver escrevendo uma extensão DbgEng que chama essa função, inclua wdbgexts.h antes de dbgeng.h (consulte Escrevendo de código de extensão DbgEng para obter detalhes).

A macro ReadTypedControlSpace32 é um wrapper fino em torno da função ReadControlSpace64. Ele é fornecido como uma conveniência para ler o espaço de controle específico do processador em uma estrutura.

void ReadTypedControlSpace32(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Especifica o número do processador cujo espaço de controle deve ser lido.

_Addr

Especifica o endereço do espaço de controle.

_Buf

Especifica o objeto no qual os dados de espaço de controle são lidos.

de valor de retorno de

Essa macro não retorna um valor.

Os parâmetros fornecidos para essa macro são os mesmos fornecidos para a função ReadControlSpace64, exceto que, em vez de fornecer um ponteiro para uma estrutura e seu tamanho, a estrutura pode ser fornecida diretamente.

A macro ReadTypedControlSpace64 é um wrapper fino em torno da função ReadControlSpace64. Ele é fornecido como uma conveniência para ler o espaço de controle específico do processador em uma estrutura.

void ReadTypedControlSpace64(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Especifica o número do processador cujo espaço de controle deve ser lido.

_Addr

Especifica o endereço do espaço de controle.

_Buf

Especifica o objeto no qual os dados de espaço de controle são lidos.

de valor de retorno de

Essa macro não retorna um valor.

Os parâmetros fornecidos para essa macro são os mesmos fornecidos para a função ReadControlSpace64, exceto que, em vez de fornecer um ponteiro para uma estrutura e seu tamanho, a estrutura pode ser fornecida diretamente.

Requisitos

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