IDirect3DDeviceManager9::ResetDevice-Methode (dxva2api.h)

  • Artikel

Legt das Direct3D-Gerät fest oder benachrichtigt den Geräte-Manager, dass das Direct3D-Gerät zurückgesetzt wurde.

Syntax

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

Parameter

[in] pDevice

Zeiger auf die IDirect3DDevice9-Schnittstelle des Direct3D-Geräts.

[in] resetToken

Token, das im pResetToken-Parameter der DXVA2CreateDirect3DDeviceManager9-Funktion empfangen wird.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG
 Ungültiges Token
D3DERR_INVALIDCALL
 Direct3D-Gerätefehler.

Hinweise

Rufen Sie beim ersten Erstellen des Direct3D-Geräte-Managers diese Methode mit einem Zeiger auf das Direct3D-Gerät auf. Der Geräte-Manager erstellt das Gerät nicht. Der Aufrufer muss zunächst den Gerätezeiger bereitstellen.

Rufen Sie auch diese Methode auf, wenn das Direct3D-Gerät verloren geht und Sie das Gerät zurücksetzen oder ein neues Gerät erstellen müssen. Dies tritt auf, wenn IDirect3DDevice9:TestCooperativeLevel D3DERR_DEVICELOST oder D3DERR_DEVICENOTRESET zurückgibt. Weitere Informationen zu verlorenen Geräten finden Sie in der Direct3D-Dokumentation.

Der parameter resetToken stellt sicher, dass nur die Komponente, die den Geräte-Manager ursprünglich erstellt hat, das aktuelle Gerät ungültig macht.

Wenn diese Methode erfolgreich ist, werden alle geöffneten Gerätehandles ungültig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dxva2api.h

Weitere Informationen

Direct3D-Geräte-Manager

IDirect3DDeviceManager9