ID3D11Device::CreateBuffer 메서드(d3d11.h)
버퍼(꼭짓점 버퍼, 인덱스 버퍼 또는 셰이더 상수 버퍼)를 만듭니다.
구문
HRESULT CreateBuffer(
[in] const D3D11_BUFFER_DESC *pDesc,
[in, optional] const D3D11_SUBRESOURCE_DATA *pInitialData,
[out, optional] ID3D11Buffer **ppBuffer
);
매개 변수
[in] pDesc
형식: const D3D11_BUFFER_DESC*
버퍼를 설명하는 D3D11_BUFFER_DESC 구조체에 대한 포인터입니다.
[in, optional] pInitialData
형식: const D3D11_SUBRESOURCE_DATA*
초기화 데이터를 설명하는 D3D11_SUBRESOURCE_DATA 구조체에 대한 포인터입니다. 사용 플래그가 D3D11_USAGE_IMMUTABLE 경우 NULL일 수 없다는 점을 제외하고 NULL을 사용하여 공간만 할당합니다.
pInitialData에 아무것도 전달하지 않으면 버퍼에 대한 메모리의 초기 콘텐츠가 정의되지 않습니다. 이 경우 리소스를 읽기 전에 다른 방법으로 버퍼 콘텐츠를 작성해야 합니다.
[out, optional] ppBuffer
형식: ID3D11Buffer**
만든 버퍼 개체의 ID3D11Buffer 인터페이스에 대한 포인터의 주소입니다. 이 매개 변수를 NULL 로 설정하여 다른 입력 매개 변수의 유효성을 검사합니다(전달을 나타내는 S_FALSE ).
반환 값
형식: HRESULT
이 메서드는 버퍼를 만들 메모리가 부족한 경우 E_OUTOFMEMORY 반환합니다. 다른 가능한 반환 값은 Direct3D 11 반환 코드를 참조하세요.
설명
예제 코드는 방법: 꼭짓점 버퍼 만들기, 방법: 인덱스 버퍼 만들기 또는 방법: 상수 버퍼 만들기를 참조하세요.
상수 버퍼(D3D11_BIND_CONSTANT_BUFFER로 설정된 D3D11_BUFFER_DESCBindFlags)의 경우D3D11_BUFFER_DESC ByteWidth 값을 16의 배수로 설정해야 하며 D3D11_REQ_CONSTANT_BUFFER_ELEMENT_COUNT 작거나 같아야 합니다.
Windows 8 이상 운영 체제에서 사용할 수 있는 Direct3D 11.1 런타임은 CreateBuffer에 다음과 같은 새로운 기능을 제공합니다.
셰이더가 액세스할 수 있는 최대 상수 버퍼 크기보다 큰 상수 버퍼를 만들 수 있습니다(4096 32비트*4개 구성 요소 상수 – 64KB). 상수 버퍼를 파이프라인에 바인딩하는 경우(예: PSSetConstantBuffers 또는 PSSetConstantBuffers1을 통해) 셰이더가 4096 상수 제한 내에 맞는 버퍼 범위를 정의할 수 있습니다.
Direct3D 11.1 런타임(Windows 8 이상 운영 체제에서 사용 가능)은 기능 수준 9.1, 9.2 및 9.3에 대해 이 기능을 에뮬레이트합니다. 따라서 이 기능은 기능 수준 9.1, 9.2 및 9.3에서 지원됩니다.
이 기능은 기능 수준 10 이상의 새 드라이버에서 항상 사용할 수 있습니다.
Direct3D 11.1보다 오래된 런타임에서는 4096보다 큰 상수 버퍼를 요청하는 CreateBuffer 호출이 실패합니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | d3d11.h |
| 라이브러리 | D3D11.lib |