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
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | d3d9helper.h (einschließlich D3D9.h) |
Bibliothek | D3D9.lib |