Compartir a través de

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

  • Artículo

Establece el dispositivo Direct3D o notifica al administrador de dispositivos que se restableció el dispositivo Direct3D.

Sintaxis

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

Parámetros

[in] pDevice

Puntero a la interfaz IDirect3DDevice9 del dispositivo Direct3D.

[in] resetToken

Token recibido en el parámetro pResetToken de la función DXVA2CreateDirect3DDeviceManager9 .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
 Token no válido
D3DERR_INVALIDCALL
 Error del dispositivo Direct3D.

Comentarios

Cuando cree por primera vez el administrador de dispositivos direct3D, llame a este método con un puntero al dispositivo Direct3D. El administrador de dispositivos no crea el dispositivo; El autor de la llamada debe proporcionar inicialmente el puntero del dispositivo.

También llama a este método si el dispositivo Direct3D se pierde y necesitas restablecer el dispositivo o crear un nuevo dispositivo. Esto ocurre si IDirect3DDevice9::TestCooperativeLevel devuelve D3DERR_DEVICELOST o D3DERR_DEVICENOTRESET. Para obtener más información sobre los dispositivos perdidos, consulte la documentación de Direct3D.

El parámetro resetToken garantiza que solo el componente que creó originalmente el administrador de dispositivos puede invalidar el dispositivo actual.

Si este método se realiza correctamente, todos los identificadores de dispositivo abiertos no son válidos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dxva2api.h

Consulte también

Direct3D Administrador de dispositivos

IDirect3DDeviceManager9