Condividi tramite


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 .

Vedi anche