Partilhar via


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

[em] Um IStream objeto 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 arquivos 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 do uso de memória potencialmente aumentado. Se definido como FALSE, ele 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 for bem-sucedido, retorna S_OK; caso contrário, retorna um código de erro. A tabela a seguir mostra os possíveis valores de retorno para esse método.

Valor Descrição
E_PDB_FORMAT Tentativa de acessar um arquivo com um formato obsoleto.
E_INVALIDARG Parâmetro inválido.
E_UNEXPECTED A fonte de dados já foi preparada.

Observações

Esse método permite que os dados de depuração para um executável sejam obtidos da memória através de um IStream objeto.

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 (através de um mecanismo de retorno de chamada), use o IDiaDataSourceEx::loadDataForExeEx método.

Ver também