IDebugProgram2::GetDisassemblyStream
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.