DXGKDDI_CREATEDEVICE 콜백 함수(d3dkmddi.h)
DXGKDDI_CREATEDEVICE 함수는 이후에 디스플레이 미니포트 드라이버의 디바이스별 함수 호출에 사용되는 그래픽 컨텍스트 디바이스를 만듭니다.
구문
DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;
NTSTATUS DxgkddiCreatedevice(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}
매개 변수
hAdapter
[in] 디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgiDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Dxgkrnl에 이 핸들을 제공했습니다.
pCreateDevice
[in/out] 그래픽 컨텍스트 디바이스를 설명하는 DXGKARG_CREATEDEVICE 구조체에 대한 포인터입니다.
반환 값
DXGKDDI_CREATEDEVICE 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | DXGKDDI_CREATEDEVICE 그래픽 컨텍스트 디바이스를 만들었습니다. |
| STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
설명
Dxgkrnl 은 디스플레이 미니포트 드라이버의 DXGKDDI_CREATEDEVICE 함수를 호출하여 그래픽 하위 시스템이 이후에 디스플레이 미니포트 드라이버에 대한 호출을 전달하는 그래픽 컨텍스트 디바이스를 만듭니다. 드라이버는 디바이스를 사용하여 렌더링 상태 컬렉션을 보유합니다. 그래픽 하위 시스템은 지정된 GPU(그래픽 처리 장치) 어댑터에서 동일한 프로세스에서 여러 디바이스를 만들 수 있습니다.
참고
동시에 존재할 수 있는 디바이스 수는 사용 가능한 시스템 메모리에 의해서만 제한됩니다. 즉, 드라이버에는 하드 코딩된 최대 디바이스 제한이 있을 수 없습니다.
일반적으로 디바이스는 서로 독립적입니다. 즉, 한 디바이스에서 만든 리소스는 다른 디바이스에서 만든 리소스에서 참조하거나 액세스할 수 없습니다. 그러나 프로세스 간 리소스는 이 규칙의 예외입니다.
DXGKDDI_CREATEDEVICE 페이지 가능으로 만들어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |