다음을 통해 공유


D3DXCreateTexture 함수

필요에 따라 호출 매개 변수를 조정하여 빈 텍스처를 만듭니다.

구문

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

매개 변수

pDevice [in]

형식: LPDIRECT3DDEVICE9

텍스처와 연결할 디바이스를 나타내는 IDirect3DDevice9 인터페이스에 대한 포인터입니다.

너비 [in]

형식: UINT

너비(픽셀)입니다. 이 값이 0이면 값 1이 사용됩니다. 설명 부분을 참조하세요.

높이 [in]

형식: UINT

높이(픽셀)입니다. 이 값이 0이면 값 1이 사용됩니다. 설명 부분을 참조하세요.

MipLevels [in]

형식: UINT

요청된 밉 수준 수입니다. 이 값이 0이거나 D3DX_DEFAULT 경우 전체 mipmap 체인이 만들어집니다.

사용량 [in]

형식: DWORD

0, D3DUSAGE_RENDERTARGET 또는 D3DUSAGE_DYNAMIC. 이 플래그를 D3DUSAGE_RENDERTARGET 설정하면 SetRenderTarget 메서드를 호출하여 표면을 렌더링 대상으로 사용할 수 있습니다. D3DUSAGE_RENDERTARGET 또는 D3DUSAGE_DYNAMIC 지정한 경우 애플리케이션은 CheckDeviceFormat을 호출하여 디바이스가 이 작업을 지원하는지 검사 합니다. 동적 텍스처 사용에 대한 자세한 내용은 동적 텍스처 사용을 참조하세요.

형식 [in]

형식: D3DFORMAT

텍스처에 대해 요청된 픽셀 형식을 설명하는 D3DFORMAT 열거형 형식의 멤버입니다. 반환된 텍스처는 디바이스가 요청된 형식을 지원하지 않는 경우 지정된 형식과 다른 형식일 수 있습니다. 애플리케이션은 반환된 텍스처의 형식을 검사 요청된 형식과 일치하는지 확인해야 합니다.

[in]

형식: D3DPOOL

텍스처를 배치해야 하는 메모리 클래스를 설명하는 D3DPOOL 열거형 형식의 멤버입니다.

ppTexture [out]

형식: LPDIRECT3DTEXTURE9*

생성된 텍스처 개체를 나타내는 IDirect3DTexture9 인터페이스에 대한 포인터의 주소입니다.

반환 값

형식: HRESULT

함수가 성공하면 반환 값이 D3D_OK. 함수가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY 중 하나일 수 있습니다.

설명

내부적으로 D3DXCreateTexture는 D3DXCheckTextureRequirements 를 사용하여 호출 매개 변수를 조정합니다. 따라서 CreateTexture 에 대한 호출이 실패하는 D3DXCreateTexture 호출이 성공하는 경우가 많습니다.

Height와 Width가 모두 D3DX_DEFAULT 설정되면 두 매개 변수 모두에 256의 값이 사용됩니다. Height 또는 Width가 D3DX_DEFAULT 설정되고 다른 매개 변수가 숫자 값으로 설정된 경우 텍스처는 높이와 너비가 숫자 값과 같은 정사각형이 됩니다.

요구 사항

요구 사항
헤더
D3dx9tex.h
라이브러리
D3dx9.lib

추가 정보

D3DX 9의 텍스처 함수