Metodo IDirect3DSurface9::GetContainer (d3d9helper.h)

Fornisce l'accesso all'oggetto trama o trama del cubo padre (mipmap), se questa superficie è un livello figlio di una trama del cubo o di un mipmap. Questo metodo può anche fornire l'accesso alla catena di scambio padre se la superficie è un elemento figlio di back-buffer.

Sintassi

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

Parametri

[in] riid

Tipo: REFIID

Identificatore di riferimento del contenitore richiesto.

[out] ppContainer

Tipo: void**

Indirizzo di un puntatore da riempire con il puntatore del contenitore se la query ha esito positivo. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.

Commenti

Se la superficie viene creata usando CreateRenderTarget o CreateOffscreenPlainSurface o CreateDepthStencilSurface, la superficie viene considerata autonoma. In questo caso, GetContainer restituirà il dispositivo Direct3D usato per creare la superficie.

Se la chiamata ha esito positivo, il conteggio dei riferimenti del contenitore viene aumentato di uno.

Ecco un esempio che ottiene la trama padre di 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;
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DSurface9