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 |