Partilhar via

Método ICorDebugRegisterSet2::GetRegisters

  • Artigo

Obtém o valor de cada registo (para a plataforma na qual o código está atualmente a ser executado) que é especificado pela máscara de bits especificada.

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
[in] O tamanho, em bytes, da mask matriz.

mask
[in] Uma matriz de bytes, cada bit do qual corresponde a um registo. Se o bit for 1, o valor do registo correspondente será obtido.

regCount
[in] O número de valores de registo a obter.

regBuffer
[fora] Uma matriz de CORDB_REGISTER objetos, cada um dos quais recebe o valor de um registo.

Observações

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

Se a máscara indicar um registo indisponível, será devolvido um valor indeterminado para esse registo.

O ICorDebugRegisterSet2::GetRegisters método é necessário para plataformas com mais de 64 registos. Por exemplo, a IA64 tem 128 registos para fins gerais e 128 registos de vírgula flutuante, pelo que precisa de mais de 64 bits na máscara de bits.

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

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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

Ver também