Método IDebugControl3::SetAssemblyOptions (dbgeng.h)
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 . Opções é 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.
Valor de retorno
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
Observações
Para obter mais informações sobre como usar o assembly com a API do mecanismo de depurador, consulte de 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 conjunto de bits 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.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |