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

Fornece acesso ao objeto de textura ou textura do cubo pai (mipmap), se essa superfície for um nível filho de uma textura de cubo ou um mipmap. Esse método também poderá fornecer acesso à cadeia de troca pai se a superfície for um filho de back-buffer.

Sintaxe

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

Parâmetros

[in] riid

Tipo: REFIID

Identificador de referência do contêiner que está sendo solicitado.

[out] ppContainer

Tipo: void**

Endereço de um ponteiro a ser preenchido com o ponteiro do contêiner se a consulta for bem-sucedida. Consulte Observações.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

Se a superfície for criada usando CreateRenderTarget ou CreateOffscreenPlainSurface ou CreateDepthStencilSurface, a superfície será considerada autônoma. Nesse caso, GetContainer retornará o dispositivo Direct3D usado para criar a superfície.

Se a chamada for bem-sucedida, a contagem de referência do contêiner será aumentada em um.

Aqui está um exemplo de obtenção da textura pai de uma superfície 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	Valor
Plataforma de Destino	Windows
Cabeçalho	d3d9helper.h (inclua D3D9.h)
Biblioteca	D3D9.lib

Confira também

IDirect3DSurface9