IDiaDataSourceEx::loadDataFromIStreamEx
Prepara i dati di debug archiviati in un file di database di programma (con estensione pdb) a cui si accede tramite un flusso di dati potenzialmente in memoria, con la prelettura dei record facoltativa.
Sintassi
HRESULT loadDataFromIStreamEx (
IStream* pIStream,
BOOL fPdbPrefetching
);
Parametri
pIStream
[in] Oggetto IStream che rappresenta il flusso di dati da utilizzare.
fPdbPrefetching
[in] Se impostato su TRUE
, i record di debug adiacenti vengono preletturati in memoria, sostituendo potenzialmente molte operazioni di I/O di file più piccole con meno operazioni di dimensioni maggiori e migliorando così la velocità effettiva complessiva man mano che tali record vengono successivamente accessibili, a scapito di un potenziale aumento dell'utilizzo della memoria. Se impostato su FALSE
, questo comportamento si comporta in modo identico a IDiaDataSource::loadDataFromIStream
. Se impostato su un altro valore, il comportamento non è specificato.
Valore restituito
Se ha esito positivo, restituisce S_OK
; in caso contrario, restituisce un codice di errore. Nella tabella seguente vengono illustrati i possibili valori restituiti per questo metodo.
valore | Descrizione |
---|---|
E_PDB_FORMAT |
Tentativo di accesso a un file con un formato obsoleto. |
E_INVALIDARG |
Parametro non valido. |
E_UNEXPECTED |
L'origine dati è già stata preparata. |
Osservazioni:
Questo metodo consente di ottenere i dati di debug per un eseguibile dalla memoria tramite un IStream oggetto .
Per caricare un file con estensione pdb senza convalida, usare il IDiaDataSourceEx::loadDataFromPdbEx
metodo .
Per convalidare il file con estensione pdb in base a criteri specifici, usare il IDiaDataSourceEx::loadAndValidateDataFromPdbEx
metodo .
Per ottenere l'accesso al processo di caricamento dei dati (tramite un meccanismo di callback), usare il IDiaDataSourceEx::loadDataForExeEx
metodo .