DXGKDDI_CONNECTDOORBELL 콜백 함수(d3dkmddi.h)

아티클
05/23/2024

중요

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

DxgkDdiConnectDoorbell 은 이전에 만든 초인종 개체 를 하드웨어 큐에 연결(또는 다시 연결)합니다.

구문

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

매개 변수

pArgs

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

반환 값

KMD가 해당 초인종 개체를 지정된 하드웨어 큐에 성공적으로 연결할 수 있으면 DxgkDdiConnectDoorbell은 STATUS_SUCCESS 반환합니다. 이 호출은 일반적으로 실패하지 않아야 합니다. 그러나 반환된 실패 코드는 복구할 수 없는 종류의 GPU 손실 또는 중지된 시나리오에서 발생합니다.

설명

UMD가 D3DKMTConnectDoorbell을 호출하면 OS는 DxgkDdiConnectDoorbell 을 호출하여 KMD가 다음을 수행할 수 있도록 합니다.

실제 초인종 위치에 매핑된 CPU 가상 주소를 제공합니다.
하드웨어 큐 개체, 초인종 개체, 초인종 물리적 주소, GPU 스케줄러 등 간에 필요한 연결을 만듭니다.

이 DDI에서 반환할 때 KMD는 이 물리적 주소를 이 특정 하드웨어 큐에 예약된 것으로 간주해야 합니다. 그러나 OS에는 초인종의 물리적 주소에 대한 고유성 요구 사항이 없습니다. 즉, KMD는 하드웨어 구현에 따라 동일한 물리적 주소를 여러 논리 초인종/하드웨어 큐와 공유하도록 선택할 수 있습니다. 예를 들어 일부 하드웨어는 단일 하드웨어 컨텍스트의 모든 하드웨어 큐에 동일한 물리적 주소를 할당하도록 선택할 수 있습니다. 여러 논리 초인종이 동일한 4KB 물리적 페이지를 공유하지만 페이지 내에서 고유한 오프셋을 사용할 수도 있습니다.

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