Share via


IDebugProgram2::GetDisassemblyStream

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

HRESULT GetDisassemblyStream( 
   DISASSEMBLY_STREAM_SCOPE   dwScope,
   IDebugCodeContext2*        pCodeContext,
   IDebugDisassemblyStream2** ppDisassemblyStream
);
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

Reference

IDebugProgram2

DISASSEMBLY_STREAM_SCOPE

IDebugCodeContext2

IDebugDisassemblyStream2