Partilhar via

Método ICorDebugRegisterSet2::GetRegisters

Obtém o valor de cada registro (para a plataforma na qual o código está sendo executado no momento) especificado pela máscara de bits fornecida.

Sintaxe

HRESULT GetRegisters (
    [in] ULONG32 maskCount,
    [in, size_is(maskCount)] BYTE mask[],
    [in] ULONG32 regCount,
    [out, size_is(regCount)] CORDB_REGISTER regBuffer[]
);

Parâmetros

maskCount [em] O tamanho, em bytes, da mask matriz.

mask [em] Uma matriz de bytes, cada bit dos quais corresponde a um registo. Se o bit for 1, o valor do registro correspondente será recuperado.

regCount [em] O número de valores de registro a serem recuperados.

regBuffer [saídas] Uma matriz de CORDB_REGISTER objetos, cada um dos quais recebe o valor de um registro.

Observações

O GetRegisters método retorna uma matriz de valores dos registradores especificados pela máscara. A matriz não contém valores de registradores cujo bit de máscara não está definido. Assim, o regBuffer tamanho da matriz deve ser igual ao número de 1's na máscara. Se o valor de regCount for muito pequeno para o número de registos indicado pela máscara, os valores dos registos numerados mais elevados serão truncados a partir do conjunto. Se regCount for muito grande, os elementos não utilizados regBuffer não serão modificados.

Se um registo indisponível for indicado pela máscara, será devolvido um valor indeterminado para esse registo.

O ICorDebugRegisterSet2::GetRegisters método é necessário para plataformas que tenham mais de 64 cadastros. Por exemplo, IA64 tem 128 registradores de uso geral e 128 registros de ponto flutuante, então você precisa de mais de 64 bits na máscara de bits.

Se você não tiver mais de 64 registros, como é o caso em plataformas como x86, o GetRegisters método apenas traduz os bytes na matriz de bytes em um ULONG64 e, em mask seguida, chama o método ICorDebugRegisterSet::GetRegisters, que usa a ULONG64 máscara.

Requerimentos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões .NET: Disponível desde: .NET Framework 2.0

Consulte também

  • Last updated on