Auf Englisch lesen

Freigeben über


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

Weitere Informationen

IDirect3DSurface9