IDirect3DDevice9::CreateTexture 메서드

텍스처 소스를 생성 한다.

구문

HRESULT CreateTexture(      

    UINT Width,
    UINT Height,
    UINT Levels,
    DWORD Usage,
    D3DFORMAT Format,
    D3DPOOL Pool,
    IDirect3DTexture9** ppTexture,
    HANDLE* pHandle
);

파라미터

Width
[in] 최상정도의 텍스처의 폭 (픽셀 단위). 밉맵 레벨이 아래의 픽셀 넓이는 1 개 위에의 레벨의 픽셀 넓이를 (단순하게) 반으로 한 값이다. 각각의 넓이는, 1 픽셀의 사이즈에 거둘 수 있다. 따라서, 2 로 나눗셈 한 결과가 0 의 경우, 대신에 1 이 사용된다.
Height
[in] 최상정도의 텍스처의 높이 (픽셀 단위). 밉맵 레벨이 아래의 픽셀 넓이는 1 개 위에의 레벨의 픽셀 넓이를 (단순하게) 반으로 한 값이다. 각각의 넓이는, 1 픽셀의 사이즈에 거둘 수 있다. 따라서, 2 로 나눗셈 한 결과가 0 의 경우, 대신에 1 이 사용된다.
Levels
[in] 텍스처에 있는 레벨의 수. 0 을 지정 하면, 밉맵화 텍스처를 지원 하는 하드웨어에 대해, Microsoft® Direct3D® 는, 1 × 1 픽셀까지의 모든 텍스처 서브 레벨을 생성한다. IDirect3DBaseTexture9::GetLevelCount 를 호출해, 생성된 레벨수를 확인한다.
Usage
[in] 사용법은 0 으로 할 수 있다. 이 경우 사용법의 값은 설정되지 않는다. 다만, 사용법이 필요한 경우는, 1 개 또는 복수의 D3DUSAGE 정수의 편성을 사용한다. 사용법파라미터와IDirect3D9::CreateDevice 의 동작 플래그를 합치시켜 사용하는 것을 추천한다.
Format
[in] D3DFORMAT 열거형의 멤버. 텍스처의 전레벨의 포맷을 기술한다.
Pool
[in] D3DPOOL 열거형의 멤버. 텍스처의 배치처가 되는 메모리 클래스를 기술한다.
ppTexture
[out, retval] 생성 된 텍스처 소스를 나타내는 IDirect3DTexture9 인터페이스의 포인터.
pHandle
[in] 예약이 끝난 상태. 이 파라미터는 NULL 로 설정한다.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
다음의 값을 돌려주는 경우도 있다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DERR_OUTOFVIDEOMEMORY Direct3D 가 처리를 실시하는데 충분한 디스플레이 메모리가 없다.
E_OUTOFMEMORY Direct3D 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

주의

애플리케이션으로 D3DUSAGE_AUTOGENMIPMAP 을 사용해 IDirect3D9::CheckDeviceFormat 를 호출하는 것에 의해, 특정의 포맷에서의밉맵의 자동 생성의 지원을 검출할 수 있다. IDirect3D9::CheckDeviceFormat 가 D3DOK_NOAUTOGEN 를 돌려주는 경우,IDirect3DDevice9::CreateTexture 는 성공하지만, 1 레벨의 텍스처를 돌려준다.

D3DERR_INVALIDCALL	메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DERR_OUTOFVIDEOMEMORY	Direct3D 가 처리를 실시하는데 충분한 디스플레이 메모리가 없다.
E_OUTOFMEMORY	Direct3D 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.