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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |