IDirect3DVolume9::GetContainer-Methode (d3d9helper.h)

Ermöglicht den Zugriff auf das Texturobjekt des übergeordneten Volumes, wenn es sich bei dieser Oberfläche um eine untergeordnete Ebene einer Volumetextur handelt.

Syntax

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

Parameter

[in] riid

Typ: REFIID

Referenzbezeichner des angeforderten Volumes.

[out, retval] ppContainer

Typ: void**

Adresse eines Zeigers, der mit dem Containerzeiger gefüllt werden soll, wenn die Abfrage erfolgreich ist.

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 der Aufruf erfolgreich ist, wird die Referenzanzahl des Containers um eins erhöht.

Hier sehen Sie ein Beispiel zum Abrufen der texturierten übergeordneten Volumes einer Volumetextur.

// Assumes pSurface is a valid IDirect3DVolume9 pointer
void *pContainer = NULL;
IDirect3DVolumeTexture9 *pVolumeTexture = NULL;
HRESULT hr = pVolume->GetContainer(IID_IDirect3DVolumeTexture9, &pContainer);
if (SUCCEEDED(hr) && pContainer)
{
    pVolumeTexture = (IDirect3DVolumeTexture9 *)pContainer;

Anforderungen

Weitere Informationen

IDirect3DVolume9