Partilhar via


Método ICorDebugRegisterSet::GetRegisters

Obtém o valor de cada registro (no computador que está executando código no momento) 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 [em] Uma máscara de bits que especifica quais valores de registro devem ser recuperados. Cada bit corresponde a um registo. Se um bit for definido como um, o valor do registro será recuperado; caso contrário, o valor do registo não 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 um valor de um registro.

Observações

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

Se a máscara de bits especificar um registro que não está disponível, GetRegisters retornará um valor indeterminado para esse registro.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponível desde 1.0

Consulte também