IDirect3DSurface9::GetContainer-Methode (d3d9.h)
Bietet Zugriff auf die übergeordnete Würfeltextur oder -textur (mipmap), wenn diese Oberfläche eine untergeordnete Ebene einer Würfeltextur oder einer Mipmap ist. Diese Methode kann auch zugriff auf die übergeordnete Swapchain ermöglichen, wenn die Oberfläche ein untergeordnetes Hintergrundpufferelement ist.
Syntax
HRESULT GetContainer(
[in] REFIID riid,
[out] void **ppContainer
);
Parameter
[in] riid
Typ: REFIID
Verweisbezeichner des angeforderten Containers.
[out] ppContainer
Typ: void**
Adresse eines Zeigers, der mit dem Containerzeiger gefüllt werden soll, wenn die Abfrage erfolgreich ist. Siehe Hinweise.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.
Hinweise
Wenn die Oberfläche mit CreateRenderTarget oder CreateOffscreenPlainSurface oder CreateDepthStencilSurface erstellt wird, gilt die Oberfläche als eigenständig. In diesem Fall gibt GetContainer das Direct3D-Gerät zurück, das zum Erstellen der Oberfläche verwendet wurde.
Wenn der Aufruf erfolgreich ist, wird die Referenzanzahl des Containers um eins erhöht.
Hier sehen Sie ein Beispiel zum Abrufen der übergeordneten Textur einer Mip-Oberfläche.
// 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;
}
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |