Edit

Share via

IDebugProgram2::GetDisassemblyStream

  • Article

Gets the disassembly stream for this program or a part of this program.

Syntax

int GetDisassemblyStream( 
   enum_DISASSEMBLY_STREAM_SCOPE  dwScope,
   IDebugCodeContext2             pCodeContext,
   out IDebugDisassemblyStream2   ppDisassemblyStream
);

Parameters

dwScope
[in] Specifies a value from the DISASSEMBLY_STREAM_SCOPE enumeration that defines the scope of the disassembly stream.

pCodeContext
[in] An IDebugCodeContext2 object that represents the position of where to start the disassembly stream.

ppDisassemblyStream
[out] Returns an IDebugDisassemblyStream2 object that represents the disassembly stream.

Return Value

If successful, returns S_OK; otherwise, returns an error code. Returns E_DISASM_NOTSUPPORTED if disassembly is not supported for this particular architecture.

Remarks

If the dwScopes parameter has the DSS_HUGE flag of the DISASSEMBLY_STREAM_SCOPE enumeration set, then the disassembly is expected to return a large number of disassembly instructions, for example, for an entire file or module. If the DSS_HUGE flag is not set, then the disassembly is expected to be confined to a small region, typically that of a single function.

See also