다음을 통해 공유


DXGKDDI_CREATECONTEXT 콜백 함수(d3dkmddi.h)

DxgkDdiCreateContext 함수는 GPU(그래픽 처리 장치) 컨텍스트를 만듭니다.

구문

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

매개 변수

[in] hDevice

새 컨텍스트가 만들어지는 그래픽 컨텍스트 디바이스에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 DxgkDdiCreateDevice 함수는 이전에 이 핸들을 DXGKARG_CREATEDEVICE 구조체의 hDevice 멤버에 있는 Microsoft DirectX 그래픽 커널 하위 시스템에 제공했습니다.

[in/out] pCreateContext

컨텍스트를 만드는 방법에 대한 정보가 포함된 DXGKARG_CREATECONTEXT 구조체에 대한 포인터입니다.

반환 값

DxgkDdiCreateContext 는 다음 값 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS DxgkDdiCreateContext가 컨텍스트를 성공적으로 만들었습니다.
STATUS_NO_MEMORY DxgkDdiCreateContext가 완료하는 데 필요한 메모리를 할당할 수 없습니다.
STATUS_GRAPHICS_DRIVER_MISMATCH 디스플레이 미니포트 드라이버는 DxgkDdiCreateContext에 대한 호출을 시작한 사용자 모드 디스플레이 드라이버와 호환되지 않습니다.

설명

드라이버는 GPU 컨텍스트를 사용하여 렌더링 상태 컬렉션을 보유합니다.

단일 프로세스는 지정된 디바이스에서 여러 컨텍스트를 만들 수 있습니다.

드라이버는 임의의 수의 컨텍스트를 지원해야 합니다. 드라이버가 컨텍스트를 만들 수 없는 유일한 유효한 이유는 시스템 메모리가 부족하기 때문입니다.

일반적으로 각 컨텍스트는 해당 컨텍스트를 소유하는 디바이스에 대해 이전에 만든 모든 리소스를 참조할 수 있습니다.

DxgkDdiCreateContext를 페이징 가능으로 만들어야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
대상 플랫폼 데스크톱
머리글 d3dkmddi.h
IRQL PASSIVE_LEVEL

추가 정보

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice