ID3D10Device::CreateTexture3D 메서드(d3d10.h)
단일 3D 텍스처를 만듭니다( Texture3D 참조).
구문
HRESULT CreateTexture3D(
[in] const D3D10_TEXTURE3D_DESC *pDesc,
[in] const D3D10_SUBRESOURCE_DATA *pInitialData,
[out] ID3D10Texture3D **ppTexture3D
);
매개 변수
[in] pDesc
형식: const D3D10_TEXTURE3D_DESC*
3D 텍스처 설명에 대한 포인터입니다( D3D10_TEXTURE3D_DESC 참조). 런타임에 서로 다른 호환되는 형식으로 해석할 수 있는 무형식 리소스를 만들려면 텍스처 설명에 무형식 형식을 지정합니다. Mipmap 수준을 자동으로 생성하려면 Mipmap 수준 수를 0으로 설정합니다.
[in] pInitialData
형식: const D3D10_SUBRESOURCE_DATA*
하위 리소스 설명 배열에 대한 포인터입니다(D3D10_SUBRESOURCE_DATA 참조). 각 하위 리소스에 대해 하나씩 정렬됩니다(텍스처 배열 인덱스, 조각 인덱스, 밉 수준별 정렬). 애플리케이션은 IMMUTABLE 리소스를 만들 때 pInitialData에 대해 NULL 을 지정할 수 없습니다( D3D10_USAGE 참조). 리소스가 다중 샘플링된 경우 다중 샘플링된 리소스를 만들 때 데이터로 초기화할 수 없으므로 pInitialData는 NULL 이어야 합니다.
[out] ppTexture3D
형식: ID3D10Texture3D**
생성된 텍스처에 대한 포인터의 주소입니다( ID3D10Texture3D 인터페이스 참조). 이 매개 변수를 NULL 로 설정하여 다른 입력 매개 변수의 유효성을 검사합니다(다른 입력 매개 변수가 유효성 검사를 통과하면 메서드가 S_FALSE 반환).
반환 값
형식: HRESULT
메서드가 성공하면 반환 코드가 S_OK. 오류 코드 실패 는 Direct3D 10 반환 코드를 참조하세요.
설명
CreateTexture3D는 1D 텍스처 배열을 포함하는 3D 텍스처 리소스를 만듭니다. 텍스처의 수는 텍스처 설명에 지정됩니다. 리소스의 모든 텍스처는 밉맵 수준의 형식, 크기 및 수가 동일해야 합니다.
모든 리소스는 하나 이상의 하위 리소스로 구성됩니다. 텍스처에 데이터를 로드하기 위해 애플리케이션은 처음에 pInitialData가 가리키는 D3D10_SUBRESOURCE_DATA 구조의 일부로 데이터를 제공하거나 SDK에서 제공하는 텍스처링 함수 중 하나를 사용할 수 있습니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | d3d10.h |
| 라이브러리 | D3D10.lib |