ID3D11Device3::CreateTexture2D1 메서드(d3d11_3.h)
2D 텍스처를 만듭니다.
구문
HRESULT CreateTexture2D1(
[in] const D3D11_TEXTURE2D_DESC1 *pDesc1,
[in, optional] const D3D11_SUBRESOURCE_DATA *pInitialData,
[out, optional] ID3D11Texture2D1 **ppTexture2D
);
매개 변수
[in] pDesc1
형식: const D3D11_TEXTURE2D_DESC1*
2D 텍스처 리소스를 설명하는 D3D11_TEXTURE2D_DESC1 구조체에 대한 포인터입니다. 런타임 시 다른 호환 형식으로 해석할 수 있는 무형식 리소스를 만들려면 텍스처 설명에 무형식 형식을 지정합니다. Mipmap 수준을 자동으로 생성하려면 mipmap 수준 수를 0으로 설정합니다.
[in, optional] pInitialData
형식: const D3D11_SUBRESOURCE_DATA*
2D 텍스처 리소스의 하위 리소스를 설명하는 D3D11_SUBRESOURCE_DATA 구조체 배열에 대한 포인터입니다. 애플리케이션은 IMMUTABLE 리소스를 만들 때 pInitialData에 대해 NULL을 지정할 수 없습니다(D3D11_USAGE 참조). 리소스가 다중 샘플링된 경우 다중 샘플링된 리소스를 만들 때 데이터로 초기화할 수 없으므로 pInitialData 는 NULL 이어야 합니다.
pInitialData에 아무것도 전달하지 않으면 리소스에 대한 메모리의 초기 콘텐츠가 정의되지 않습니다. 이 경우 리소스를 읽기 전에 다른 방법으로 리소스 콘텐츠를 작성해야 합니다.
다음 계산을 사용하여 pDesc1이 가리키는 D3D11_TEXTURE2D_DESC1 구조체의 MipLevels 및 ArraySize 멤버의 값에서 이 배열의 크기를 확인할 수 있습니다.
MipLevels * ArraySize
이 배열 크기에 대한 자세한 내용은 비고를 참조하세요.
[out, optional] ppTexture2D
형식: ID3D11Texture2D1**
생성된 텍스처에 대한 ID3D11Texture2D1 인터페이스에 대한 포인터를 수신하는 메모리 블록에 대한 포인터입니다. 이 매개 변수를 NULL 로 설정하여 다른 입력 매개 변수의 유효성을 검사합니다(다른 입력 매개 변수가 유효성 검사를 통과하면 메서드가 S_FALSE 반환됨).
반환 값
형식: HRESULT
메서드가 성공하면 반환 코드가 S_OK. 오류 코드 실패 는 Direct3D 11 반환 코드를 참조하세요.
설명
CreateTexture2D1 은 여러 2D 하위 리소스를 포함할 수 있는 2D 텍스처 리소스를 만듭니다. 하위 리소스 수는 텍스처 설명에 지정됩니다. 리소스의 모든 텍스처는 동일한 형식, 크기 및 mipmap 수준 수를 가져야 합니다.
모든 리소스는 하나 이상의 하위 리소스로 구성됩니다. 텍스처에 데이터를 로드하기 위해 애플리케이션은 처음에 데이터를 pInitialData가 가리키는 D3D11_SUBRESOURCE_DATA 구조의 배열로 제공하거나 D3DX11CreateTextureFromFile과 같은 D3DX 텍스처 함수 중 하나를 사용할 수 있습니다.
전체 mipmap 체인이 있는 32 x 32 텍스처의 경우 pInitialData 배열에는 다음과 같은 6개 요소가 있습니다.
- pInitialData[0] = 32x32
- pInitialData[1] = 16x16
- pInitialData[2] = 8x8
- pInitialData[3] = 4x4
- pInitialData[4] = 2x2
- pInitialData[5] = 1x1
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | d3d11_3.h |
| 라이브러리 | D3D11.lib |