IDiaDataSourceEx::loadDataFromIStreamEx
Prepara os dados de depuração armazenados em um arquivo de banco de dados de programa (.pdb) acessado por meio de um fluxo de dados potencialmente na memória, com pré-busca de registro opcional.
Sintaxe
HRESULT loadDataFromIStreamEx (
IStream* pIStream,
BOOL fPdbPrefetching
);
Parâmetros
pIStream
[in] Um objeto IStream que representa o fluxo de dados a ser usado.
fPdbPrefetching
[em] Se definido como TRUE, os registros de depuração adjacentes são pré-buscados na memória, potencialmente substituindo muitas operações de E/S de arquivo menores por menos operações maiores e, assim, melhorando a taxa de transferência geral à medida que esses registros são acessados posteriormente, às custas de um uso de memória potencialmente aumentado. Se definido como FALSE, isso se comporta de forma idêntica a IDiaDataSource::loadDataFromIStream. Se definido como algum outro valor, o comportamento não será especificado.
Valor de retorno
Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro. A tabela a seguir mostra os possíveis valores retornados para esse método.
| Valor | Descrição |
|---|---|
E_PDB_FORMAT |
Ocorreu uma tentativa de acessar um arquivo com um formato obsoleto. |
E_INVALIDARG |
Parâmetro inválido. |
E_UNEXPECTED |
A fonte de dados já foi preparada. |
Comentários
Esse método permite que os dados de depuração de um executável sejam obtidos da memória por meio de um objeto IStream.
Para carregar um arquivo .pdb sem validação, use o IDiaDataSourceEx::loadDataFromPdbEx método.
Para validar o arquivo .pdb em relação a critérios específicos, use o IDiaDataSourceEx::loadAndValidateDataFromPdbEx método.
Para obter acesso ao processo de carregamento de dados (por meio de um mecanismo de retorno de chamada), use o IDiaDataSourceEx::loadDataForExeEx método.