Méthode IDirect3DSurface9 ::GetContainer (d3d9helper.h)

Fournit l’accès à l’objet de texture ou de texture de cube parent (mipmap), si cette surface est un niveau enfant d’une texture de cube ou d’un mipmap. Cette méthode peut également fournir l’accès à la chaîne d’échange parente si la surface est un enfant de mémoire tampon arrière.

Syntaxe

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

Paramètres

[in] riid

Type : REFIID

Identificateur de référence du conteneur demandé.

[out] ppContainer

Type : void**

Adresse d’un pointeur à remplir avec le pointeur de conteneur si la requête réussit. Consultez la section Notes.

Valeur de retour

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.

Remarques

Si la surface est créée à l’aide de CreateRenderTarget , CreateOffscreenPlainSurface ou CreateDepthStencilSurface, la surface est considérée comme autonome. Dans ce cas, GetContainer retourne l’appareil Direct3D utilisé pour créer la surface.

Si l’appel réussit, le nombre de références du conteneur est augmenté d’un.

Voici un exemple d’obtention de la texture parente d’une surface 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;
}

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3d9helper.h (inclure D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DSurface9