IDirect3DDeviceManager9::TestDevice-Methode (dxva2api.h)

Testet, ob ein Direct3D-Gerätehandle gültig ist.

Syntax

HRESULT TestDevice(
  [in] HANDLE hDevice
);

Parameter

[in] hDevice

Handle mit einem Direct3D-Gerät. Um ein Gerätehandle abzurufen, rufen Sie IDirect3DDeviceManager9::OpenDeviceHandle auf.

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
Das Gerätehandle ist gültig.
E_HANDLE
Der angegebene Handle ist kein Direct3D-Gerätehandle.
DXVA2_E_NEW_VIDEO_DEVICE
Das Gerätehandle ist ungültig.

Hinweise

Wenn die Methode DXVA2_E_NEW_VIDEO_DEVICE zurückgibt, rufen Sie IDirect3DDeviceManager9::CloseDeviceHandle auf, um das Handle zu schließen, und rufen Sie dann OpenDeviceHandle erneut auf, um ein neues Handle abzurufen. Mit der IDirect3DDeviceManager9::ResetDevice-Methode werden alle geöffneten Gerätehandles ungültig.

Anforderungen

   
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