IDebugDisassemblyStream2::Read

讀取從反組譯碼數據流中目前位置開始的指示。

語法

C#

int Read( 
   uint                           dwInstructions,
   enum_DISASSEMBLY_STREAM_FIELDS dwFields,
   out uint                       pdwInstructionsRead,
   DisassemblyData[]              prgDisassembly
);

C++

HRESULT Read( 
   DWORD                     dwInstructions,
   DISASSEMBLY_STREAM_FIELDS dwFields,
   DWORD*                    pdwInstructionsRead,
   DisassemblyData*          prgDisassembly
);

參數

dwInstructions
[in]要反組譯的指令數目。 此值也是陣列的最大 prgDisassembly 長度。

dwFields
[in]DISASSEMBLY_STREAM_FIELDS 列舉中的旗標組合，表示要填寫的欄位prgDisassembly。

pdwInstructionsRead
[out]傳回實際反組譯的指令數目。

prgDisassembly
[out]已填入反組譯碼的 DisassemblyData 結構的陣列，每個反組譯指令各一個結構。 這個陣列的長度是由 dwInstructions 參數所決定。

傳回值

如果成功，則會傳回 S_OK；否則，會傳回錯誤碼。

備註

呼叫 GetSize 方法，即可取得目前範圍中可用的最大指令數目。

呼叫 Seek 方法，即可變更下一個指令讀取位置的目前位置。

DSF_OPERANDS_SYMBOLS旗標可以新增至 DSF_OPERANDS 參數中的 dwFields 旗標，以指出在反組譯指令時應該使用符號名稱。

另請參閱

• IDebugDisassemblyStream2
• DISASSEMBLY_STREAM_FIELDS
• DisassemblyData
• GetSize
• Seek