D3DXLoadMeshFromXof 함수

ID3DXFileData 개체에서 메시를 로드합니다.

구문

HRESULT D3DXLoadMeshFromXof(
  _In_    LPD3DXFILEDATA    pxofMesh,
  _Out_   DWORD             Options,
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Out_   LPD3DXBUFFER      *ppAdjacency,
  _Inout_ LPD3DXBUFFER      *ppMaterials,
  _Out_   LPD3DXBUFFER      *ppEffectInstances,
  _Inout_ DWORD             *pNumMaterials,
  _Out_   LPD3DXMESH        *ppMesh
);

매개 변수

pxofMesh [in]

형식: LPD3DXFILEDATA

로드할 파일 데이터 개체를 나타내는 ID3DXFileData 인터페이스에 대한 포인터입니다.

옵션 [out]

형식: DWORD

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

pDevice [in]

형식: LPDIRECT3DDEVICE9

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

ppAdjacency [out]

형식: LPD3DXBUFFER*

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

ppMaterials [in, out]

형식: LPD3DXBUFFER*

ID3DXBuffer 인터페이스에 대한 포인터의 주소입니다. 메서드가 반환되면 이 매개 변수는 D3DXMATERIAL 구조체의 배열로 채워집니다.

ppEffectInstances [out]

형식: LPD3DXBUFFER*

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

pNumMaterials [in, out]

형식: DWORD*

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

ppMesh [out]

형식: LPD3DXMESH*

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

반환 값

형식: HRESULT

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

설명

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

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

요구 사항

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

추가 정보

메시 함수

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE