Compartilhar via

IDiaDataSourceEx::loadDataFromIStreamEx

Prepara os dados de depuração armazenados em um arquivo de banco de dados do 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 IStream objeto que representa o fluxo de dados a ser usado.

fPdbPrefetching

[in] Se definido como TRUE, os registros de depuração adjacentes são pré-buscados na memória, potencialmente substituindo muitas operações menores de E/S de arquivo por menos operações maiores e, portanto, melhorando a taxa de transferência geral à medida que esses registros são acessados posteriormente, em detrimento do potencial aumento do uso da memória. 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, retorna um código de erro. A tabela a seguir mostra os possíveis valores retornados para este 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 de um executável sejam obtidos da memória por meio 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 (por meio de um mecanismo de retorno de chamada), use o IDiaDataSourceEx::loadDataForExeEx método.

Consulte também

  • Last updated on