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

  • [アーティクル]

Direct3D デバイスを設定するか、Direct3D デバイスがリセットされたことをデバイス マネージャーに通知します。

構文

HRESULT ResetDevice(
  [in] IDirect3DDevice9 *pDevice,
  [in] UINT             resetToken
);

パラメーター

[in] pDevice

Direct3D デバイスの IDirect3DDevice9 インターフェイスへのポインター。

[in] resetToken

DXVA2CreateDirect3DDeviceManager9 関数の pResetToken パラメーターで受信したトークン。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
E_INVALIDARG
 トークンが無効
D3DERR_INVALIDCALL
 Direct3D デバイス エラー。

注釈

Direct3D デバイス マネージャーを初めて作成するときは、Direct3D デバイスへのポインターを使用してこのメソッドを呼び出します。 デバイス マネージャーはデバイスを作成しません。呼び出し元は、最初にデバイス ポインターを指定する必要があります。

また、Direct3D デバイスが紛失し、デバイスをリセットするか、新しいデバイスを作成する必要がある場合は、このメソッドを呼び出します。 これは、 IDirect3DDevice9::TestCooperativeLevel がD3DERR_DEVICELOSTまたはD3DERR_DEVICENOTRESETを返した場合に発生します。 紛失したデバイスの詳細については、Direct3D のドキュメントを参照してください。

resetToken パラメーターを使用すると、最初にデバイス マネージャーを作成したコンポーネントのみが現在のデバイスを無効にすることができます。

このメソッドが成功すると、開いているすべてのデバイス ハンドルが無効になります。

要件

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

こちらもご覧ください

Direct3D デバイス マネージャー

IDirect3DDeviceManager9