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.

Retornar valor

Nenhum

Comentários

Se você estiver escrevendo 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 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.

Valor de retorno

Essa macro não retorna um valor.

Os parâmetros fornecidos para essa macro são os mesmos fornecidos à 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.

Valor de retorno

Essa macro não retorna um valor.

Os parâmetros fornecidos para essa macro são os mesmos fornecidos à 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
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdbgexts.h (inclua Wdbgexts.h, Dbgeng.h)