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

こちらもご覧ください

IDirect3DSurface9