D3DXLoadMeshFromX 함수

DirectX .x 파일에서 메시를 로드합니다.

구문

HRESULT D3DXLoadMeshFromX(
  _In_  LPCTSTR           pFilename,
  _In_  DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppAdjacency,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ DWORD             *pNumMaterials,
  _Out_ LPD3DXMESH        *ppMesh
);

매개 변수

pFilename [in]

형식: LPCTSTR

파일 이름을 지정하는 문자열에 대한 포인터입니다. 컴파일러 설정에 유니코드가 필요한 경우 데이터 형식 LPCTSTR이 LPCWSTR로 확인됩니다. 그렇지 않으면 문자열 데이터 형식이 LPCSTR로 확인됩니다. 설명 부분을 참조하세요.

옵션 [in]

형식: DWORD

메시에 대한 만들기 옵션을 지정하는 D3DXMESH 열거형에서 하나 이상의 플래그를 조합합니다.

pD3DDevice [in]

형식: LPDIRECT3DDEVICE9

메시와 연결된 디바이스 개체인 IDirect3DDevice9 인터페이스에 대한 포인터입니다.

ppAdjacency [out]

형식: LPD3DXBUFFER*

인접 데이터가 포함된 버퍼에 대한 포인터입니다. 인접 데이터에는 메시의 각 면에 대해 세 개의 인접 항목을 지정하는 얼굴당 3개의 DWORD 배열이 포함되어 있습니다. 버퍼에 액세스하는 방법에 대한 자세한 내용은 ID3DXBuffer를 참조하세요.

ppMaterials [out]

형식: LPD3DXBUFFER*

재질 데이터가 포함된 버퍼에 대한 포인터입니다. 버퍼에는 DirectX 파일의 정보를 포함하는 D3DXMATERIAL 구조의 배열이 포함되어 있습니다. 버퍼에 액세스하는 방법에 대한 자세한 내용은 ID3DXBuffer를 참조하세요.

ppEffectInstances [out]

형식: LPD3DXBUFFER*

반환된 메시의 특성 그룹당 하나씩 효과 인스턴스의 배열을 포함하는 버퍼에 대한 포인터입니다. 효과 instance 효과를 초기화하는 데 사용되는 상태 정보의 특정 instance. D3DXEFFECTINSTANCE를 참조하세요. 버퍼에 액세스하는 방법에 대한 자세한 내용은 ID3DXBuffer를 참조하세요.

pNumMaterials [out]

형식: DWORD*

메서드가 반환되는 ppMaterials 배열의 D3DXMATERIAL 구조체 수에 대한 포인터입니다.

ppMesh [out]

형식: LPD3DXMESH*

로드된 메시를 나타내는 ID3DXMesh 인터페이스에 대한 포인터의 주소입니다.

반환 값

형식: HRESULT

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

설명

컴파일러 설정은 함수 버전도 결정합니다. 유니코드가 정의되면 함수 호출이 D3DXLoadMeshFromXW로 확인됩니다. 그렇지 않으면 ANSI 문자열이 사용되므로 함수 호출이 D3DXLoadMeshFromXA로 확인됩니다.

파일의 모든 메시는 하나의 출력 메시로 축소됩니다. 파일에 프레임 계층 구조가 포함되어 있으면 모든 변환이 메시에 적용됩니다.

효과 instance 정보를 포함하지 않는 메시 파일의 경우 .x 파일의 재질 정보에서 기본 효과 인스턴스가 생성됩니다. instance 기본 효과에는 D3DMATERIAL9 구조체의 멤버에 해당하는 기본값이 있습니다.

기본 텍스처 이름도 채워지지만 다르게 처리됩니다. 이름은 "Name"이라는 주석이 있는 "Texture0"의 이름으로 효과 변수에 해당하는 Texture0@Name. 여기에는 텍스처의 문자열 파일 이름이 포함됩니다.

요구 사항

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

추가 정보

메시 함수

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE