Метод IDirect3DDeviceManager9::ResetDevice (dxva2api.h)

  • Статья

Задает устройство Direct3D или уведомляет диспетчер устройств о том, что устройство Direct3D было сброшено.

Синтаксис

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

Параметры

[in] pDevice

Указатель на интерфейс IDirect3DDevice9 устройства Direct3D.

[in] resetToken

Маркер, полученный в параметре pResetToken функции DXVA2CreateDirect3DeviceManager9 .

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 Invalid token (Недопустимый токен)
D3DERR_INVALIDCALL
 Ошибка устройства Direct3D.

Комментарии

При первом создании диспетчера устройств Direct3D вызовите этот метод с указателем на устройство Direct3D. Диспетчер устройств не создает устройство; вызывающий объект должен изначально предоставить указатель устройства.

Кроме того, вызовите этот метод, если устройство Direct3D теряется и вам нужно сбросить устройство или создать новое устройство. Это происходит, если IDirect3DDevice9::TestCooperativeLevel возвращает D3DERR_DEVICELOST или D3DERR_DEVICENOTRESET. Дополнительные сведения об утерянных устройствах см. в документации по Direct3D.

Параметр resetToken гарантирует, что только компонент, который изначально создал диспетчер устройств, может сделать недействительным текущее устройство.

Если этот метод будет выполнен успешно, все открытые дескрипторы устройств становятся недействительными.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header dxva2api.h

См. также раздел

Диспетчер устройств Direct3D

IDirect3DDeviceManager9