Método ICorDebugRegisterSet::GetRegisters

  • Artigo

Obtém o valor de cada registro (no computador que está executando o código) especificado pela máscara de bits.

Sintaxe

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

Parâmetros

mask
[in] Uma máscara de bits que especifica quais valores de registro devem ser recuperados. Cada bit corresponde a um registro. Se um bit for definido como um, o valor do registro será recuperado; caso contrário, ele não será recuperado.

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

regBuffer
[out] Uma matriz de objetos CORDB_REGISTER, cada um deles recebe um valor de um registro.

Comentários

O tamanho da matriz deve ser igual ao número de bits definido como um na máscara de bits. O parâmetro regCount especifica o número de elementos no buffer que receberão os valores de registro. Se o valor de regCount for muito pequeno para o número de registros indicados pela máscara, os registros numerados mais altos serão truncados do conjunto. Se o valor de regCount for muito grande, os elementos regBuffer não utilizados não serão modificados.

Se a máscara de bits especificar um registro indisponível, GetRegisters retornará um valor indeterminado para esse registro.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponíveis desde a versão 1.0

Confira também