Méthode IDirect3DSurface9::GetContainer (d3d9.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.
Notes
Si la surface est créée à l’aide de CreateRenderTarget ou 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;
}
Spécifications
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |