IDirect3DDeviceManager9::TestDevice メソッド (dxva2api.h)

  • [アーティクル]

Direct3D デバイス ハンドルが有効かどうかをテストします。

構文

HRESULT TestDevice(
  [in] HANDLE hDevice
);

パラメーター

[in] hDevice

Direct3D デバイスへのハンドル。 デバイス ハンドルを取得するには、 IDirect3DDeviceManager9::OpenDeviceHandle を呼び出します。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 デバイス ハンドルが有効です。
E_HANDLE
 指定したハンドルは Direct3D デバイス ハンドルではありません。
DXVA2_E_NEW_VIDEO_DEVICE
 デバイス ハンドルが無効です。

解説

メソッドがDXVA2_E_NEW_VIDEO_DEVICEを返す場合は、 IDirect3DDeviceManager9::CloseDeviceHandle を呼び出してハンドルを閉じ、もう一度 OpenDeviceHandle を呼び出して新しいハンドルを取得します。 IDirect3DDeviceManager9::ResetDevice メソッドは、開いているすべてのデバイス ハンドルを無効にします。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー dxva2api.h

関連項目

Direct3D デバイス マネージャー

IDirect3DDeviceManager9