D3DXCreateTextureFromFileInMemoryEx 함수

메모리의 파일에서 질감을 만듭니다. D3DXCreateTextureFromFileInMemory보다 고급 함수입니다.

구문

HRESULT D3DXCreateTextureFromFileInMemoryEx(
  _In_    LPDIRECT3DDEVICE9  pDevice,
  _In_    LPCVOID            pSrcData,
  _In_    UINT               SrcDataSize,
  _In_    UINT               Width,
  _In_    UINT               Height,
  _In_    UINT               MipLevels,
  _In_    DWORD              Usage,
  _In_    D3DFORMAT          Format,
  _In_    D3DPOOL            Pool,
  _In_    DWORD              Filter,
  _In_    DWORD              MipFilter,
  _In_    D3DCOLOR           ColorKey,
  _Inout_ D3DXIMAGE_INFO     *pSrcInfo,
  _Out_   PALETTEENTRY       *pPalette,
  _Out_   LPDIRECT3DTEXTURE9 *ppTexture
);

매개 변수

pDevice [ in]

유형: LPDIRECT3DDEVICE9

질감과 연결될 디바이스를 나타내는 IDirect3DDevice9 인터페이스에 대한 포인터입니다.

pSrcData [ in]

유형: LPCVOID

질감을 만들 메모리의 파일에 대한 포인터입니다.

SrcDataSize [ in]

유형: UINT

메모리에 있는 파일의 크기(바이트)입니다.

Width [ in]

유형: UINT

너비(픽셀)입니다. 이 값이 0 또는 D3DX _ DEFAULT이면 파일에서 차원이 사용됩니다.

높이 [ in]

유형: UINT

높이(픽셀)입니다. 이 값이 0 또는 D3DX _ DEFAULT이면 파일에서 차원이 사용됩니다.

MipLevels [ in]

유형: UINT

요청된 mip 수준 수입니다. 이 값이 0 또는 D3DX _ DEFAULT이면 전체 mipmap 체인이 만들어집니다.

사용량 [ in]

유형: DWORD

0, D3DUSAGE _ RENDERTARGET 또는 D3DUSAGE _ DYNAMIC. 이 플래그를 D3DUSAGE _ RENDERTARGET으로 설정하면 표면이 렌더링 대상으로 사용된다는 것을 나타냅니다. 그런 다음, 리소스를 SetRenderTarget 메서드의 pNewRenderTarget 매개 변수에 전달할 수 있습니다. D3DUSAGE _ RENDERTARGET 또는 D3DUSAGE DYNAMIC이 지정된 경우 _ 풀을 D3DPOOL DEFAULT로 설정해야 _ 하며, 애플리케이션은 CheckDeviceFormat을 호출하여 디바이스가 이 작업을 지원하는지 확인해야 합니다. 동적 질감 사용에 대한 자세한 내용은 동적 질감 사용을 참조하세요.

형식 지정 [ in]

유형: D3DFORMAT

질감에 대해 요청된 픽셀 형식을 설명하는 D3DFORMAT 열거형 형식의 멤버입니다. 반환된 질감의 형식이 형식으로 지정된 형식과 다를 수 있습니다. 애플리케이션은 반환된 질감의 형식을 확인해야 합니다. D3DFMT _ UNKNOWN인경우 파일에서 형식을 사용합니다. D3DFMT _ FROM FILE인 경우 _ 형식은 파일에 있는 그대로 사용되며, 디바이스 기능을 위반하는 경우 호출이 실패합니다.

[ in]

유형: D3DPOOL

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

필터 [ in]

유형: DWORD

이미지를 필터링하는 방법을 제어하는 하나 이상의 플래그 조합입니다. 이 매개 변수에 대해 D3DX _ DEFAULT를 지정하는 것은 D3DX _ FILTER TRIANGLE _ | D3DX _ FILTER _ DITHER를 지정하는 것과 같습니다. 유효한 각 필터는 D3DX _ FILTER의 플래그 중 하나를 포함해야 합니다.

MipFilter [ in]

유형: DWORD

이미지를 필터링하는 방법을 제어하는 하나 이상의 플래그 조합입니다. 이 매개 변수에 대해 D3DX _ DEFAULT를 지정하는 것은 D3DX FILTER BOX를 지정하는 것과 _ _ 같습니다. 유효한 각 필터는 D3DX _ FILTER의 플래그 중 하나를 포함해야 합니다. 또한 비트 27-31을 사용하여 .dds 질감이 메모리에 로드될 때 건너뛸 mip 수준(mip 맵 체인의 맨 위에서)을 지정합니다. 이를 통해 최대 32개 수준을 건너뛸 수 있습니다.

ColorKey [ in]

형식: D3DCOLOR

투명 검은색으로 바꿀 D3DCOLOR 값이거나, 색 키를 사용하지 않도록 설정하려면 0입니다. 원본 이미지 형식과는 독립적으로 항상 32비트 ARGB 색입니다. 알파는 중요하며 일반적으로 불투명 색 키에 대해 FF로 설정해야 합니다. 따라서 불투명 검은색의 경우 값은 0xFF000000 같습니다.

pSrcInfo [ in, out]

유형: D3DXIMAGE _ 정보*

원본 이미지 파일의 데이터에 대한 설명으로 채울 D3DXIMAGE _ INFO 구조체에 대한 포인터이거나 NULL 입니다.

pPalette [ out]

유형: PALETTEENTRY*

채울 256색 색상표를 나타내는 PALETTEENTRY 구조체에 대한 포인터 또는 NULL 입니다. 설명 부분을 참조하세요.

ppTexture [ out]

유형: LPDIRECT3DTEXTURE9*

만든 질감 개체를 나타내는 IDirect3DTexture9 인터페이스에 대한 포인터의 주소입니다.

반환 값

유형: HRESULT

함수가 성공하면 반환 값은 D3D _ OK입니다. 함수가 실패하면 반환 값은 D3DERR _ NOTAVAILABLE, D3DERR _ OUTOFVIDEOMEMORY, D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA, E _ OUTOFMEMORY 중 하나일 수 있습니다.

설명

이 함수는 .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm 및 .tga 파일 형식을 지원합니다. D3DXIMAGE _ FILEFORMAT을참조하세요.

PALETTEENTRY에대한 자세한 내용은 플랫폼 SDK를 참조하세요. DirectX 8.0에서는 PALETTEENTRY 구조체의 peFlags 멤버가 Platform SDK에 설명된 대로 작동하지 않습니다. peFlags 멤버는 이제 8비트 팔레트 형식의 알파 채널입니다.

.dds 파일을 로드하는 동안 mipap 수준을 건너뛰는 경우 _ _ D3DX SKIP DDS _ MIP LEVELS 매크로를 사용하여 _ MipFilter 값을 생성합니다. 이 매크로는 건너뛸 수준 수와 필터 형식을 사용하여 필터 값을 반환합니다. 그러면 MipFilter 매개 변수에 전달됩니다.

요구 사항

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

참고 항목

D3DXCreateTextureFromFileInMemory

D3DX 9의 질감 함수