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

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

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

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

Observações

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

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

O ICorDebugRegisterSet2::GetRegisters método é necessário para plataformas com mais de 64 registros. Por exemplo, IA64 tem 128 registros de uso geral e 128 registros de ponto flutuante, portanto, 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 converte 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.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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

Consulte também

  • Last updated on