IDirect3DDeviceManager9::TestDevice-Methode (dxva2api.h)

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

Syntax

HRESULT TestDevice(
  [in] HANDLE hDevice
);

[in] hDevice

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

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.

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.


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