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;
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | d3d9helper.h(D3D9.h 포함) |
| 라이브러리 | D3D9.lib |