D3DKMTDestroyDoorbell 함수(d3dkmthk.h)

아티클
05/23/2024

중요

일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. 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 할당에 대한 참조를 제거합니다.
DoorbellStatusCPUVirtualAddress가 가리키는 매핑을 해제합니다.
DoorbellCPUVirtuslAddress가 가리키는 사용자 모드 및 커널 모드 매핑을 모두 해제합니다.
KMD가 실제 초인종 위치를 분리하고 초인종 개체를 파괴할 수 있도록 KMD의 [DxgkDdiDestroyDoorbell]을 호출합니다.

UMD는 D3DKMTDestroyDoorbell을 호출한 후 핸들을 사용하면 안됩니다.

자세한 내용은 사용자 모드 작업 제출을 참조하세요.