Freigeben über


IDirect3DDeviceManager9::OpenDeviceHandle-Methode (dxva2api.h)

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

Syntax

HRESULT OpenDeviceHandle(
  [out] HANDLE *phDevice
);

Parameter

[out] phDevice

Empfängt das Gerätehandle.

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

Hinweise

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.

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