D3DKMTDestroyDoorbell 함수(d3dkmthk.h)

중요

일부 정보는 상용 출시 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

D3DKMTDestroyDoorbell 은 초인종 개체를 파괴합니다.

구문

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

매개 변수

unnamedParam1

[in] 초인종을 제거해야 하는 하드웨어 큐를 식별하는 D3DKMT_DESTROY_DOORBELL 구조체에 대한 포인터입니다.

반환 값

D3DKMTDestroyDoorbell 은 OS가 초인종 개체를 성공적으로 삭제하면 STATUS_SUCCESS 반환합니다. hDoorbell이 유효한 초인종을 가리키는 경우 이 호출은 항상 성공합니다. 그렇지 않으면 STATUS_INVALID_PARAMETER 반환합니다.

설명

UMD가 D3DKMTDestroyDoorbell을 호출하면 OS는 다음을 수행합니다.

  • hRingBuffer 및 이 초인종에 속하는 hRingBufferControl 할당에 대한 참조를 제거합니다.
  • pDoorbellStatusCPUVirtualAddress가 가리키는 매핑을 해제합니다.
  • pDoorbellCPUVirtuslAddress가 가리키는 사용자 모드 및 커널 모드 매핑을 모두 해제합니다.
  • KMD가 물리적 초인종 위치를 분리하고 초인종 개체를 삭제할 수 있도록 KMD의 [DxgkDdiDestroyDoorbell]을 호출합니다.

UMD는 D3DKMTDestroyDoorbell을 호출한 후 핸들을 사용하지 않아야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 WIN11_FUTURE
머리글 d3dkmthk.h

추가 정보

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell