Metodo ICorProfilerInfo2::GetCodeInfo2

Articolo
08/11/2011

Ottiene le estensioni del codice nativo associato al parametro FunctionID specificato.

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

Parametri

functionID
[in] ID della funzione alla quale è associato il codice nativo.
cCodeInfos
[in] Dimensione della matrice codeInfos.
pcCodeInfos
[out] Puntatore al numero complessivo di strutture COR_PRF_CODE_INFO disponibili.
codeInfos
[out] Buffer fornito dal chiamante. Dopo il completamento, il metodo conterrà una matrice di strutture COR_PRF_CODE_INFO ciascuna delle quali descrive un blocco di codice nativo.

Note

L'ambito è ordinato in sequenza crescente in base all'offset MSIL (Microsoft Intermediate Language).

Dopo il completamento del metodo GetCodeInfo2, è necessario verificare se il buffer codeInfos fosse abbastanza grande per contenere le strutture COR_PRF_CODE_INFO. A tal fine, confrontare il valore di cCodeInfos con il valore del parametro cchName. Se cCodeInfos diviso la dimensione di una struttura COR_PRF_CODE_INFO è inferiore a pcCodeInfos, allocare un buffer codeInfos più grande, aggiornare cCodeInfos con la nuova dimensione e chiamare nuovamente GetCodeInfo2.

In alternativa, è possibile chiamare dapprima GetCodeInfo2 con un buffer codeInfos di lunghezza zero per ottenere la dimensione del buffer corretta. È quindi possibile impostare la dimensione del buffer codeInfos sul valore restituito in pcCodeInfos moltiplicato la dimensione di una struttura COR_PRF_CODE_INFO e chiamare nuovamente GetCodeInfo2.

Per ulteriori informazioni su questi due approcci, vedere Convenzioni dei metodi dell'API di profilatura.