Metode IDirect3DSurface9::GetContainer (d3d9helper.h)

Menyediakan akses ke tekstur kubus induk atau objek tekstur (mipmap), jika permukaan ini adalah tingkat anak dari tekstur kubus atau mipmap. Metode ini juga dapat menyediakan akses ke rantai pertukaran induk jika permukaannya adalah anak buffer belakang.

Sintaks

HRESULT GetContainer(
  [in]  REFIID riid,
  [out] void   **ppContainer
);

Parameter

[in] riid

Jenis: REFIID

Pengidentifikasi referensi kontainer yang diminta.

[out] ppContainer

Jenis: void**

Alamat penunjuk untuk diisi dengan penunjuk kontainer jika kueri berhasil. Lihat Keterangan.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL.

Keterangan

Jika permukaan dibuat menggunakan CreateRenderTarget atau CreateOffscreenPlainSurface atau CreateDepthStencilSurface, permukaan dianggap berdiri sendiri. Dalam hal ini, GetContainer akan mengembalikan perangkat Direct3D yang digunakan untuk membuat permukaan.

Jika panggilan berhasil, jumlah referensi kontainer ditingkatkan satu.

Berikut adalah contoh mendapatkan tekstur induk dari permukaan mip.

    
// 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;
}

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d3d9helper.h (termasuk D3D9.h)
Pustaka	D3D9.lib

Lihat juga

IDirect3DSurface9