PFND3DDDI_CREATECONTEXTCB 콜백 함수(d3dumddi.h)

Direct3D 런타임의 pfnCreateContextCb 콜백 함수는 컨텍스트를 만듭니다.

통사론

PFND3DDDI_CREATECONTEXTCB Pfnd3dddiCreatecontextcb;

HRESULT Pfnd3dddiCreatecontextcb(
  HANDLE hDevice,
  D3DDDICB_CREATECONTEXT *unnamedParam2
)
{...}

매개 변수

hDevice

[in] 컨텍스트를 만들 디바이스에 대한 핸들입니다.

unnamedParam2

[in/out] 드라이버가 컨텍스트를 만드는 데 필요한 정보로 채우는 D3DDDICB_CREATECONTEXT 구조체에 대한 포인터입니다. 이 구조에는 만들 컨텍스트의 동작 및 기능을 지정하는 노드 서수, 엔진 선호도 및 플래그와 같은 세부 정보가 포함됩니다. 성공적으로 완료되면 런타임은 새로 만든 컨텍스트에 대한 정보로 이 구조를 업데이트합니다.

반환 값

pfnCreateContextCb 컨텍스트 만들기 요청의 성공 또는 실패를 나타내는 HRESULT를 반환합니다. 일반적인 반환 값은 다음과 같습니다.

반환 코드	의미
S_OK	컨텍스트가 성공적으로 생성되었습니다.
E_OUTOFMEMORY	컨텍스트를 만들 메모리가 부족합니다.
E_INVALIDARG	제공된 인수 중 하나 이상이 잘못되었습니다.

발언

UMD(사용자 모드 표시 드라이버)는 CreateDevice 구현에서 pfnCreateContextCb 명시적으로 호출하여 디바이스와 연결된 GPU 컨텍스트를 만들어야 합니다. GPU 컨텍스트는 새로 만든 디바이스에서 실행되는 GPU 스레드입니다.

컨텍스트는 GPU가 렌더링 작업을 수행하는 데 사용하는 상태 및 명령 버퍼를 캡슐화합니다. UMD는 리소스를 확보하는 최종 소멸을 포함하여 생성되는 컨텍스트의 수명 주기를 관리합니다.

렌더링 디바이스를 만드는 방법에 대한 자세한 내용은 WDDM(Windows 디스플레이 드라이버 모델) 작업 흐름참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista(WDDM 1.0)
헤더	d3dumddi.h

참고 항목

D3DDDICB_CREATECONTEXT

pfnDestroyContextCb