IDirect3DSurface9::GetContainer 메서드(d3d9helper.h)

이 표면이 큐브 텍스처 또는 밉맵의 자식 수준인 경우 부모 큐브 텍스처 또는 텍스처(mipmap) 개체에 대한 액세스를 제공합니다. 이 메서드는 표면이 백 버퍼 자식인 경우 부모 스왑 체인에 대한 액세스를 제공할 수도 있습니다.

구문

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

매개 변수

[in] riid

형식: REFIID

요청되는 컨테이너의 참조 식별자입니다.

[out] ppContainer

형식: void**

쿼리가 성공하면 컨테이너 포인터로 채울 포인터의 주소입니다. 설명 부분을 참조하세요.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값을 D3DERR_INVALIDCALL 수 있습니다.

설명

CreateRenderTarget 또는 CreateOffscreenPlainSurface 또는 CreateDepthStencilSurface를 사용하여 표면을 만든 경우 표면은 독립 실행형으로 간주됩니다. 이 경우 GetContainer 는 표면을 만드는 데 사용되는 Direct3D 디바이스를 반환합니다.

호출이 성공하면 컨테이너의 참조 수가 1씩 증가합니다.

다음은 밉 표면의 부모 텍스처를 가져오는 예제입니다.

    
// 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;
}

요구 사항

추가 정보

IDirect3DSurface9