Método IDebugControl2::D isassemble (dbgeng.h)
El Desensamblar método desensamblaje una instrucción de procesador en la memoria del destino.
Sintaxis
HRESULT Disassemble(
[in] ULONG64 Offset,
[in] ULONG Flags,
[out, optional] PSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG DisassemblySize,
[out] PULONG64 EndOffset
);
Parámetros
[in] Offset
Especifica la ubicación en la memoria del destino de la instrucción que se va a desensamblar.
[in] Flags
Especifica las marcas de bits que afectan al comportamiento de este método. Actualmente, la única marca que se puede establecer es DEBUG_DISASM_EFFECTIVE_ADDRESS; cuando se establece, el motor calculará la dirección efectiva de la información de registro actual y la mostrará.
[out, optional] Buffer
Recibe la instrucción desensamblada. Si de búfer es NULL, no se devuelve esta información.
[in] BufferSize
Especifica el tamaño, en caracteres, del búfer de búfer.
[out, optional] DisassemblySize
Recibe el tamaño, en caracteres, de la instrucción desensambblada. Si desensamblarSize es null, no se devuelve esta información.
[out] EndOffset
Recibe la ubicación en la memoria del destino de la instrucción después de la instrucción desensamblada.
Valor devuelto
Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El método se realizó correctamente. Sin embargo, Búfer era demasiado pequeño para contener la instrucción desensambblada y la instrucción se truncaba para ajustarse. |
Observaciones
El lenguaje de ensamblado depende del tipo de procesador efectivo del sistema de destino. Para obtener información sobre el lenguaje de ensamblado, consulte la documentación del procesador.
Las opciones de desensamblaje devueltas por GetAssemblyOptions--afectan al funcionamiento de este método.
Para obtener información general sobre el uso del ensamblado en aplicaciones del depurador, consulte Depuración en modo de ensamblado. Para obtener más información sobre el uso del ensamblado con la API del motor de depurador, consulte Instrucciones de montaje y desensamblado.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |