Método IDebugControl3::SetAssemblyOptions (dbgeng.h)

Artigo
02/23/2024

O método SetAssemblyOptions define as opções de assembly e desmontagem que afetam como o mecanismo de depurador monta e desmonta as instruções do processador para o destino.

Sintaxe

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Parâmetros

[in] Options

Especifica as novas opções de assembly e desmontagem a serem usadas pelo mecanismo de depurador. As opções são um conjunto de bits; ele substituirá as opções de assembly e desmontagem existentes. Para obter valores possíveis, consulte Comentários. DEBUG_ASMOPT_DEFAULT pode ser usado para definir as opções padrão.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Para obter mais informações sobre como usar o assembly com a API do mecanismo de depurador, consulte Instruções de montagem e desmontagem.

As opções de assembly e desmontagem afetam como o mecanismo de depurador monta e desmonta as instruções do processador para o destino.

As opções são representadas por um bitset com os sinalizadores de bit a seguir.

Constante	Descrição
DEBUG_ASMOPT_VERBOSE	Quando esse bit é definido, informações adicionais são incluídas na desmontagem. Isso é equivalente à opção detalhada no comando .asm .
DEBUG_ASMOPT_NO_CODE_BYTES	Quando esse bit é definido, os bytes brutos para uma instrução não são incluídos na desmontagem. Isso é equivalente à opção no_code_bytes no comando .asm .
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Quando esse bit é definido, o depurador ignora a largura da exibição de saída ao formatar instruções durante a desmontagem. Isso é equivalente à opção ignore_output_width no comando .asm .
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	Quando esse bit é definido, cada linha da saída de desmontagem é prefixada com o número de linha do código-fonte fornecido pelas informações de símbolo. Isso é equivalente à opção source_line no comando .asm .

Além disso, o valor DEBUG_ASMOPT_DEFAULT representa o conjunto padrão de opções de assembly e desmontagem. Isso significa que todas as opções na tabela anterior estão desativadas.