PFND3D10DDI_DESTROYDEVICE コールバック関数 (d3d10umddi.h)

  • [アーティクル]

DestroyDevice(D3D10) 関数は、指定されたデバイス オブジェクトを破棄します。

構文

PFND3D10DDI_DESTROYDEVICE Pfnd3d10ddiDestroydevice;

void Pfnd3d10ddiDestroydevice(
  D3D10DDI_HDEVICE unnamedParam1
)
{...}

パラメーター

unnamedParam1

hDevice

ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。 Microsoft Direct3D ランタイムは、以前にオブジェクトに割り当てたメモリ領域を解放します。 そのため、ドライバーは、このメモリ領域にアクセスできなくなります。

戻り値

なし

解説

ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。

Direct3D ランタイムが DestroyDevice(D3D10) を呼び出す前に、ディスプレイ デバイスのすべての子オブジェクト (ブレンド状態、リソースなど) が破棄されます。

ドライバーは、D3DDDIERR_DEVICEREMOVEDを除き、エラーが発生しないようにする必要があります。 したがって、ドライバーが pfnSetErrorCb 関数の呼び出しで、D3DDDIERR_DEVICEREMOVEDを除くエラーを渡した場合、Direct3D ランタイムはエラーが重大であると判断します。 デバイスが削除された場合でも、ドライバーはD3DDDIERR_DEVICEREMOVEDを返す必要はありません。ただし、デバイスの削除が DestroyDevice(D3D10) の 操作に干渉した場合 (通常は発生しないはずです)、ドライバーはD3DDDIERR_DEVICEREMOVEDを返すことができます。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header d3d10umddi.h (D3d10umddi.h を含む)

こちらもご覧ください

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb