IDirect3DSurface9::GetContainer メソッド (d3d9helper.h)
このサーフェスがキューブ テクスチャまたはミップマップの子レベルである場合は、親キューブ テクスチャまたはテクスチャ (mipmap) オブジェクトへのアクセスを提供します。 このメソッドは、サーフェスがバック バッファーの子である場合に、親スワップ チェーンへのアクセスを提供することもできます。
構文
HRESULT GetContainer(
[in] REFIID riid,
[out] void **ppContainer
);
パラメーター
[in] riid
種類: REFIID
要求されているコンテナーの参照識別子。
[out] ppContainer
型: void**
クエリが成功した場合にコンテナー ポインターで埋めるポインターのアドレス。 「解説」を参照してください。
戻り値
種類: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合は、戻り値をD3DERR_INVALIDCALLできます。
注釈
CreateRenderTarget または CreateOffscreenPlainSurface または CreateDepthStencilSurface を使用してサーフェスを作成した場合、サーフェスはスタンドアロンと見なされます。 この場合、 GetContainer は、サーフェスの作成に使用される Direct3D デバイスを返します。
呼び出しが成功すると、コンテナーの参照カウントが 1 ずつ増加します。
ミップ サーフェスの親テクスチャを取得する例を次に示します。
// Assumes pSurface is a valid IDirect3DSurface9 pointer
void *pContainer = NULL;
IDirect3DTexture9 *pTexture = NULL;
HRESULT hr = pSurface->GetContainer(IID_IDirect3DTexture9, &pContainer);
if (SUCCEEDED(hr) && pContainer)
{
pTexture = (IDirect3DTexture9 *)pContainer;
}
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9helper.h (D3D9.h を含む) |
| Library | D3D9.lib |