IDiaDataSourceEx::loadDataFromIStreamEx
Подготавливает отладочные данные, хранящиеся в файле базы данных программы (PDB), доступ к нему с помощью потенциального потока данных в памяти с необязательным предварительным получением записей.
Синтаксис
HRESULT loadDataFromIStreamEx (
IStream* pIStream,
BOOL fPdbPrefetching
);
Параметры
pIStream
[in] Объект IStream , представляющий используемый поток данных.
fPdbPrefetching
[in] Если задано значение TRUE, смежные записи отладки предварительно извлекаются в память, потенциально заменяя многие операции ввода-вывода меньшего размера файлов меньшими, большими операциями и таким образом повышая общую пропускную способность по мере последующего доступа к этим записям, за счет потенциально повышенного использования памяти. Если задано значение FALSE, это поведение идентично IDiaDataSource::loadDataFromIStream. Если задано какое-то другое значение, поведение не указано.
Возвращаемое значение
В случае успешного выполнения возвращается S_OK; в противном случае возвращается код ошибки. В следующей таблице показаны возможные возвращаемые значения для этого метода.
| значение | Описание |
|---|---|
E_PDB_FORMAT |
Попытка получить доступ к файлу с устаревшим форматом. |
E_INVALIDARG |
Недопустимый параметр . |
E_UNEXPECTED |
Источник данных уже подготовлен. |
Замечания
Этот метод позволяет получать данные отладки для исполняемого файла из памяти через IStream объект.
Чтобы загрузить PDB-файл без проверки, используйте IDiaDataSourceEx::loadDataFromPdbEx этот метод.
Чтобы проверить PDB-файл с определенными критериями, используйте IDiaDataSourceEx::loadAndValidateDataFromPdbEx этот метод.
Чтобы получить доступ к процессу загрузки данных (с помощью механизма обратного вызова), используйте IDiaDataSourceEx::loadDataForExeEx этот метод.