IDirect3DDeviceManager9::OpenDeviceHandle-Methode (dxva2api.h)

Ruft ein Handle für das Direct3D-Gerät ab.

Syntax

HRESULT OpenDeviceHandle(
  [out] HANDLE *phDevice
);

[out] phDevice

Empfängt das Gerätehandle.

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.
DXVA2_E_NOT_INITIALIZED	Der Direct3D-Geräte-Manager wurde nicht initialisiert. Der Besitzer des Geräts muss IDirect3DDeviceManager9::ResetDevice aufrufen.

Um den IDirect3DDevice9-Zeiger des Direct3D-Geräts abzurufen, rufen Sie IDirect3DDeviceManager9::LockDevice auf, wobei der Handle in phDevice zurückgegeben wird. Schließen Sie das Gerätehandle, wenn Sie es verwenden, indem Sie IDirect3DDeviceManager9::CloseDeviceHandle aufrufen.

Um zu testen, ob ein Gerätehandle noch gültig ist, rufen Sie IDirect3DDeviceManager9::TestDevice auf.

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