Método IDirect3DDeviceManager9::ResetDevice (dxva2api.h)

  • Artigo

Define o dispositivo Direct3D ou notifica o gerenciador de dispositivos de que o dispositivo Direct3D foi redefinido.

Sintaxe

HRESULT ResetDevice(
  [in] IDirect3DDevice9 *pDevice,
  [in] UINT             resetToken
);

Parâmetros

[in] pDevice

Ponteiro para a interface IDirect3DDevice9 do dispositivo Direct3D.

[in] resetToken

Token recebido no parâmetro pResetToken da função DXVA2CreateDirect3DDeviceManager9 .

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 Token inválido
D3DERR_INVALIDCALL
 Erro de dispositivo Direct3D.

Comentários

Ao criar pela primeira vez o gerenciador de dispositivos Direct3D, chame esse método com um ponteiro para o dispositivo Direct3D. O gerenciador de dispositivos não cria o dispositivo; o chamador deve fornecer o ponteiro do dispositivo inicialmente.

Chame também esse método se o dispositivo Direct3D for perdido e você precisar redefinir o dispositivo ou criar um novo dispositivo. Isso ocorrerá se IDirect3DDevice9::TestCooperativeLevel retornar D3DERR_DEVICELOST ou D3DERR_DEVICENOTRESET. Para obter mais informações sobre dispositivos perdidos, consulte a documentação do Direct3D.

O parâmetro resetToken garante que apenas o componente que criou originalmente o gerenciador de dispositivos possa invalidar o dispositivo atual.

Se esse método for bem-sucedido, todos os identificadores de dispositivo abertos se tornarão inválidos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dxva2api.h

Confira também

Gerenciador de Dispositivos Direct3D

IDirect3DDeviceManager9