IDiaDataSourceEx::loadDataFromIStreamEx
Przygotowuje dane debugowania przechowywane w pliku bazy danych programu (.pdb) dostępne za pośrednictwem potencjalnie w pamięci strumienia danych z opcjonalnym pobieraniem rekordów.
Składnia
HRESULT loadDataFromIStreamEx (
IStream* pIStream,
BOOL fPdbPrefetching
);
Parametry
pIStream
[in] Obiekt IStream reprezentujący strumień danych do użycia.
fPdbPrefetching
[in] Jeśli ustawiono TRUEwartość , sąsiadujące rekordy debugowania są wstępnie pobierane do pamięci, potencjalnie zastępując wiele mniejszych operacji we/wy plików mniejszą liczbą, większymi operacjami, a tym samym poprawiając ogólną przepływność, ponieważ te rekordy są następnie dostępne, kosztem potencjalnie zwiększonego użycia pamięci. Jeśli jest ustawiona wartość FALSE, zachowuje się identycznie z wartością IDiaDataSource::loadDataFromIStream. Jeśli zostanie ustawiona inna wartość, zachowanie jest nieokreślone.
Wartość zwracana
Jeśli operacja powiedzie się, zwraca wartość S_OK; w przeciwnym razie zwraca kod błędu. W poniższej tabeli przedstawiono możliwe wartości zwracane dla tej metody.
| Wartość | Opis |
|---|---|
E_PDB_FORMAT |
Podjęto próbę uzyskania dostępu do pliku w przestarzałym formacie. |
E_INVALIDARG |
Nieprawidłowy parametr. |
E_UNEXPECTED |
Źródło danych zostało już przygotowane. |
Uwagi
Ta metoda umożliwia debugowanie danych pliku wykonywalnego do uzyskania z pamięci za pośrednictwem IStream obiektu.
Aby załadować plik .pdb bez walidacji, użyj IDiaDataSourceEx::loadDataFromPdbEx metody .
Aby zweryfikować plik .pdb pod kątem określonych kryteriów, użyj IDiaDataSourceEx::loadAndValidateDataFromPdbEx metody .
Aby uzyskać dostęp do procesu ładowania danych (za pomocą mechanizmu wywołania zwrotnego), użyj IDiaDataSourceEx::loadDataForExeEx metody .