DXGKDDI_CONNECTDOORBELL 콜백 함수(d3dkmddi.h)
중요
일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. 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 실제 페이지를 공유하지만 페이지 내에서 고유한 오프셋을 사용할 수도 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | WIN11_FUTURE |
머리글 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기