DXGKDDI_DISCONNECTDOORBELL 콜백 함수(d3dkmddi.h)

아티클
05/23/2024

중요

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

DxgkDdiDisconnectDoorbell 함수는 하드웨어 큐에서 이전에 연결된 초인종의 연결을 끊습니다.

구문

DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;

NTSTATUS DxgkddiDisconnectdoorbell(
  INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}

매개 변수

pArgs

[in/out] 연결을 끊을 초인종을 설명하는 DXGKARG_DISCONNECTDOORBELL 구조체에 대한 포인터입니다.

반환 값

DxgkDdiDisconnectDoorbell 은 성공하고 STATUS_SUCCESS 반환해야 합니다.

설명

OS는 DxgkDdiDisconnectDoorbell 을 호출하여 이 초인종에 할당된 실제 초인종 위치의 매핑을 해제합니다. KMD는 하드웨어 큐, 초인종 물리적 주소 및 엔진 등의 연결을 끊어야 합니다. 물리적 초인종 위치는 다른 논리 초인종 개체에 할당할 수 있습니다.

초인종 개체가 제거되지 않고 나중에 다시 연결할 수 있으므로 KMD는 hDoorbell 과 연결된 다른 개체를 삭제하거나 해제해서는 안 됩니다.

이 DDI 호출에서 반환되면 Dxgkrnl 은 다음 단계를 수행하여 초인종의 연결을 끊습니다.

UMD가 더 이상 실제 초인종 위치에 쓸 수 없도록 사용자 모드 DoorbellCpuVirtualAddress 를 더미 페이지로 회전합니다.
UMD 에서 초인종의 연결이 끊어지는 것을 알 수 있도록 D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY DoorbellStatusCpuVirtualAddress에 씁니다.

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