Método IHostMemoryManager::VirtualQuery

Artigo
08/25/2010

Serve sistema autônomo um wrapper lógico para a função Win32 correspondente. A implementação de Win32 de VirtualQuery recupera informações sobre um intervalo de páginas no espaço de endereço virtual do processo de chamada.

HRESULT VirtualQuery (
    [in]  void*    lpAddress,
    [out] void*    lpBuffer,
    [in]  SIZE_T   dwLength,
    [out] SIZE_T*  pResult
);

Parâmetros

lpAddress
[in] Um ponteiro para o endereço na memória virtual a ser consultado.
lpBuffer
[out] Um ponteiro para uma estrutura que contém informações sobre a região de memória especificado.
dwLength
[in] O dimensionar, em bytes do buffer que lpBuffer aponta para.
pResult
[out] Um ponteiro para o número de bytes retornados pelo buffer de informações.

Valor de retorno

HRESULT	Descrição
S_OK	VirtualQuery retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

VirtualQuery Fornece informações sobre um intervalo de páginas no espaço de endereço virtual do processo de chamada. Essa implementação define o valor do pResult parâmetro para o número de bytes retornados em buffer de informações e retorna um valor HRESULT. No Win32 VirtualQuery função, o valor retornado é o dimensionar do buffer. Para obter mais informações, consulte a documentação da plataforma Windows.

Observação importante:
Implementação do sistema operacional VirtualQuery não incorrem em deadlock e pode executar até a conclusão com aleatórios threads suspensos no código do usuário. Excelente cuidado ao implementar uma versão hospedada desse método.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído sistema autônomo um recurso em MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Interface IHostMemoryManager

Partilhar via