Método IDirect3DSurface9::GetContainer (d3d9helper.h)

Proporciona acceso al objeto primario de textura o textura del cubo (mipmap), si esta superficie es un nivel secundario de una textura de cubo o un mapa mip. Este método también puede proporcionar acceso a la cadena de intercambio primaria si la superficie es un elemento secundario de búfer de reserva.

Sintaxis

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

Parámetros

[in] riid

Tipo: REFIID

Identificador de referencia del contenedor que se solicita.

[out] ppContainer

Tipo: void**

Dirección de un puntero que se va a rellenar con el puntero de contenedor si la consulta se realiza correctamente. Vea la sección Comentarios.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

Si la superficie se crea con CreateRenderTarget o CreateOffscreenPlainSurface o CreateDepthStencilSurface, la superficie se considera independiente. En este caso, GetContainer devolverá el dispositivo Direct3D usado para crear la superficie.

Si la llamada se realiza correctamente, el recuento de referencias del contenedor se incrementa en uno.

Este es un ejemplo de obtención de la textura primaria de una superficie 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;
}

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d9helper.h (incluya D3D9.h)
Library	D3D9.lib

Consulte también

IDirect3DSurface9