Metode IDirect3DDeviceManager9::ResetDevice (dxva2api.h)

  • Artikel

Mengatur perangkat Direct3D atau memberi tahu manajer perangkat bahwa perangkat Direct3D direset.

Sintaks

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

Parameter

[in] pDevice

Arahkan ke antarmuka IDirect3DDevice9 dari perangkat Direct3D.

[in] resetToken

Token diterima dalam parameter pResetToken dari fungsi DXVA2CreateDirect3DDeviceManager9 .

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_INVALIDARG
 Token tidak valid
D3DERR_INVALIDCALL
 Kesalahan perangkat Direct3D.

Keterangan

Ketika Anda pertama kali membuat manajer perangkat Direct3D, panggil metode ini dengan penunjuk ke perangkat Direct3D. Manajer perangkat tidak membuat perangkat; pemanggil harus menyediakan penunjuk perangkat pada awalnya.

Panggil juga metode ini jika perangkat Direct3D hilang dan Anda perlu mengatur ulang perangkat atau membuat perangkat baru. Ini terjadi jika IDirect3DDevice9::TestCooperativeLevel mengembalikan D3DERR_DEVICELOST atau D3DERR_DEVICENOTRESET. Untuk informasi selengkapnya tentang perangkat yang hilang, lihat dokumentasi Direct3D.

Parameter resetToken memastikan bahwa hanya komponen yang awalnya membuat manajer perangkat yang dapat membatalkan perangkat saat ini.

Jika metode ini berhasil, semua handel perangkat terbuka menjadi tidak valid.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header dxva2api.h

Lihat juga

Manajer Perangkat Direct3D

IDirect3DDeviceManager9