DXGKDDI_CREATEDEVICE 콜백 함수(d3dkmddi.h)

DxgkDdiCreateDevice 함수는 이후에 디스플레이 미니포트 드라이버의 디바이스별 함수 호출에 사용되는 그래픽 컨텍스트 디바이스를 만듭니다.

구문

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

NTSTATUS DxgkddiCreatedevice(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Microsoft DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in/out] pCreateDevice

그래픽 컨텍스트 디바이스를 설명하는 DXGKARG_CREATEDEVICE 구조체에 대한 포인터입니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	DxgkDdiCreateDevice가 그래픽 컨텍스트 디바이스를 성공적으로 만들었습니다.
STATUS_NO_MEMORY	DxgkDdiCreateDevice가 완료하는 데 필요한 메모리를 할당할 수 없습니다.

설명

DirectX 그래픽 커널 하위 시스템은 디스플레이 미니포트 드라이버의 DxgkDdiCreateDevice 함수를 호출하여 그래픽 하위 시스템이 이후에 디스플레이 미니포트 드라이버에 대한 호출을 전달하는 그래픽 컨텍스트 디바이스를 만듭니다. 드라이버는 디바이스를 사용하여 렌더링 상태 컬렉션을 보유합니다. 그래픽 하위 시스템은 지정된 GPU(그래픽 처리 장치) 어댑터에서 동일한 프로세스에서 여러 디바이스를 만들 수 있습니다.

참고 동시에 존재할 수 있는 디바이스 수는 사용 가능한 시스템 메모리에 의해서만 제한됩니다. 즉, 드라이버에는 하드 코딩된 최대 디바이스 제한이 있을 수 없습니다.

일반적으로 디바이스는 서로 독립적입니다. 즉, 한 디바이스에서 만든 리소스는 다른 디바이스에서 만든 리소스에서 참조하거나 액세스할 수 없습니다. 그러나 프로세스 간 리소스는 이 규칙의 예외입니다.

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

요구 사항

지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
헤더	d3dkmddi.h
IRQL	PASSIVE_LEVEL

참고 항목

DXGKARG_CREATEDEVICE

DxgkDdiAddDevice