IDirect3DMobileDevice::Reset

9/8/2008

Este método redefine o tipo, tamanho e formato de encadear a trocar.

Syntax

HRESULT Reset(
  D3DMPRESENT_PARAMETERS* pPresentationParameters
);

Parameters

• pPresentationParameters
  [no] Ponteiro para um D3DMPRESENT_PARAMETERS estrutura que descreve os novos parâmetros apresentação. Este valor não pode ser NULL.

Return Value

Se o método for bem-sucedido, o valor de retorno é D3DM_OK (consulte Valores D3DM).

Se o método falhar, o valor de retorno pode E_OUTOFMEMORY, ou uma do seguinte Valores D3DMERR.

• D3DMERR_INVALIDCALL
• D3DMERR_MEMORYPOOLEMPTY

Remarks

Se um chamar para Redefinir falhar, o dispositivo será colocado no "perdidas" estado, a menos que ele já esteja em de " Não redefinir " estado.

Chamando IDirect3DMobileDevice::Reset Faz com que todos os textura superfícies memória sejam perdidos, gerenciado Textures para ser liberado de vídeo memória e todos os informações do estado sejam perdidos. Antes chamado de IDirect3DMobileDevice::Reset método para um dispositivo, um aplicativo deve versão qualquer processar explícita de destinos, superfícies estêncil profundidade, cadeias trocar adicionais, e D3DMPOOL Recursos associado com o dispositivo.

Os tipos diferentes de cadeias trocar são completos-Tela ou em janela. Se o novo encadear trocar estiver cheia-Tela, o adaptador será colocado em de modo de exibição que corresponda ao novo tamanho.

Os aplicativos podem esperar que as mensagens sejam enviadas para eles durante este chamar (por exemplo, antes este chamar é retornado); Os aplicativos devem tomar precauções não para chamar em Direct3D Mobile nesse tempo. Além disso, quando IDirect3DMobileDevice::Reset falhar, o válido apenas métodos que podem ser chamado é IDirect3DMobileDevice::Reset, IDirect3DMobileDevice::TestCooperativeLevel, e o vários Lançamento funções membro. Chamar qualquer outro método pode resultar em uma exceção.

Um chamar para IDirect3DMobileDevice::Reset falhará se chamado em um segmento diferente do que o segmento usado para criar o dispositivo que está sendo redefinir.

Requirements

See Also

Reference

IDirect3DMobileDevice
D3DMPRESENT_PARAMETERS
IDirect3DMobileDevice::TestCooperativeLevel
D3DMPOOL