다음을 통해 공유


DXGKDDI_CANCELCOMMAND 콜백 함수(d3dkmddi.h)

GPU 스케줄러의 소프트웨어 큐에 있었지만 디바이스가 오류 상태로 전환되어 하드웨어 큐에 도달하지 않은 DMA(직접 메모리 액세스) 패킷과 연결된 내부 리소스를 정리합니다. 이러한 오류 상태는 일반적으로 TDR(시간 제한 검색 및 복구) 이벤트로 인해 발생합니다.

구문

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

매개 변수

hAdapter

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

pCancelCommand

하드웨어 큐에서 명령을 제거한 후 정리할 리소스를 지정하는 DXGKARG_CANCELCOMMAND 구조체에 대한 포인터입니다.

반환 값

성공적으로 완료되면 STATUS_SUCCESS 반환합니다. 드라이버가 오류 코드를 반환하는 경우 운영 체제에서 시스템 버그 검사가 발생합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

설명

참고 DirectX 그래픽 커널 하위 시스템은 DXGK_VIDSCHCAPS 경우에만 이 함수를 호출합니다. CancelCommandAware 멤버가 설정됩니다.
 
드라이버가 오류 코드를 반환하는 경우 DirectX 그래픽 커널 하위 시스템에서 시스템 버그 검사가 발생합니다. 크래시 덤프 파일에서 오류는 다음 네 개의 매개 변수가 있는 BugCheck 0x119 메시지로 표시됩니다.
  1. 0x9
  2. 실패한 드라이버 호출에서 반환된 NTSTATUS 오류 코드
  3. DXGKARG_CANCELCOMMAND 구조체에 대한 포인터
  4. 내부 스케줄러 데이터 구조에 대한 포인터

요구 사항

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

추가 정보

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice