D3DKMTSubmitCommand 함수(d3dkmthk.h)

D3DKMTSubmitCommand 는 GPU(그래픽 처리 장치) 가상 주소 지정을 지원하는 컨텍스트에서 명령 버퍼를 제출하는 데 사용됩니다. 이러한 컨텍스트는 사용자 모드에서 직접 명령을 생성하고, 자체 명령 버퍼 풀을 관리하며, 할당 또는 패치 위치 목록을 사용하지 않습니다.

구문

NTSTATUS D3DKMTSubmitCommand(
  [in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);

매개 변수

[in] unnamedParam1

작업을 설명하는 D3DKMT_SUBMITCOMMAND 구조체에 대한 포인터입니다.

반환 값

반환 코드	설명
STATUS_SUCCESS	디바이스 컨텍스트가 성공적으로 만들어졌습니다.
STATUS_INVALID_PARAMETER	매개 변수의 유효성이 검사되었고 잘못된 것으로 확인되었습니다.

이 함수는 다른 NTSTATUS 값을 반환할 수도 있습니다.

설명

이 함수는 이러한 컨텍스트에 대한 이전 Render 함수를 대체하며 해당 위치에서 사용해야 합니다. 레거시 패치 모드에서 작동하는 컨텍스트는 이전 Render 함수를 계속 사용해야 합니다.

사용자 모드 드라이버는 패치 위치를 생성하지 않지만 기록 중인 기본 항목 목록을 생성해야 합니다. 비디오 메모리 관리자는 할당 목록을 사용하여 각 명령 버퍼에서 쓰기 위해 참조되는 기본 할당을 결정합니다. 이 정보는 대칭 이동 작업으로 주 복제본에 렌더링을 동기화하는 데 사용됩니다.

일부 커널 모드 드라이버는 GPU에 특정 DMA(직접 메모리 액세스) 버퍼를 제출하는 방법에 대한 사용자 모드 드라이버의 정보가 필요합니다. WDDM(Windows 디스플레이 드라이버 모델) 1.0에서 이 정보는 사용자 모드 드라이버에서 명령 버퍼를 통해 커널 모드 드라이버로 전송되었습니다. DMA 버퍼는 사용자 모드 드라이버에 의해 직접 빌드되고 수정 없이 GPU에 제출되므로 더 이상 커널 드라이버에 정보를 보내는 데 사용할 수 없습니다. 사용자 모드와 커널 모드 드라이버 간에 정보를 전송할 수 있도록 명시적 프라이빗 드라이버 데이터 버퍼가 제출과 함께 전송되도록 추가되었습니다.

참고

이 프라이빗 드라이버 데이터는 단방향이며 커널 모드 드라이버는 이 버퍼를 통해 사용자 모드 드라이버에 정보를 반환할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
지원되는 최소 서버	Windows Server 2016
대상 플랫폼	유니버설
헤더	d3dkmthk.h(D3dkmthk.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll

추가 정보

D3DKMT_SUBMITCOMMAND