ICorProfilerInfo2::GetCodeInfo2 方法

發行項
08/12/2011

取得與指定的 FunctionID 關聯的機器碼延伸。

HRESULT GetCodeInfo2(
    [in]  FunctionID functionID,
    [in]  ULONG32 cCodeInfos,
    [out] ULONG32 *pcCodeInfos,
    [out, size_is(cCodeInfos), length_is(*pcCodeInfos)]
    COR_PRF_CODE_INFO codeInfos[]);

參數

functionID
[in] 與機器碼關聯的函式 ID。
cCodeInfos
[in] codeInfos 陣列的大小。
pcCodeInfos
[out] 可用之 COR_PRF_CODE_INFO 結構總數的指標。
codeInfos
[out] 呼叫端提供的緩衝區。方法傳回之後，將會包含 COR_PRF_CODE_INFO 結構的陣列，而每個結構都會描述機器碼的區塊。

備註

延伸是依照遞增 Microsoft Intermediate Language (MSIL) 位移排序的。

GetCodeInfo2 傳回之後，您必須驗證 codeInfos 緩衝區夠大，足以包含所有 COR_PRF_CODE_INFO 結構。若要完成這項工作，請比較 cCodeInfos 的值和 cchName 參數的值。如果以 COR_PRF_CODE_INFO 結構的大小相除的 cCodeInfos 類似於 pcCodeInfos，請配置較大的 codeInfos 緩衝區、以新的較大的大小更新 cCodeInfos，然後再次呼叫 GetCodeInfo2。

另外，您也可以先使用長度為零的 codeInfos 緩衝區來呼叫 GetCodeInfo2，以取得正確的緩衝區大小。接著您就可以將 codeInfos 緩衝區大小設為 pcCodeInfos 中傳回的值 (以 COR_PRF_CODE_INFO 結構的大小相乘)，然後再次呼叫 GetCodeInfo2。

如需這兩種方法的詳細資訊，請參閱程式碼剖析 API 方法慣例。