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 |