DXGKDDI_CONNECTDOORBELL 콜백 함수(d3dkmddi.h)
중요하다
일부 정보는 상용 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보와 관련하여 명시적이거나 묵시적인 보증을 하지 않습니다.
DxgkDdiConnectDoorbell 이전에 만든 초인종 개체를 하드웨어 큐에 연결하거나 다시 연결합니다.
통사론
DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;
NTSTATUS DxgkddiConnectdoorbell(
INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}
매개 변수
pArgs
[in/out] 연결할 초인종을 설명하는 DXGKARG_CONNECTDOORBELL 구조체에 대한 포인터입니다.
반환 값
DxgkDdiConnectDoorbell KMD가 해당 초인종 개체를 지정된 하드웨어 큐에 성공적으로 연결할 수 있으면 STATUS_SUCCESS 반환합니다. 이 호출은 일반적으로 실패하지 않아야 합니다. 그러나 반환된 실패 코드는 복구할 수 없는 시나리오의 손실 또는 중지된 종류의 GPU에서 발생합니다.
발언
UMD가 D3DKMTConnectDoorbell호출하면 OS는 DxgkDdiConnectDoorbell 호출하여 KMD에서 다음을 수행할 수 있도록 합니다.
- 실제 초인종 위치에 매핑된 CPU 가상 주소를 제공합니다.
- 하드웨어 큐 개체, 초인종 개체, 초인종 물리적 주소, GPU 스케줄러 등 간에 필요한 연결을 만듭니다.
이 DDI에서 반환될 때 KMD는 이 물리적 주소를 이 특정 하드웨어 큐에 예약된 것으로 간주해야 합니다. 그러나 OS에는 초인종의 물리적 주소에 대한 고유성 요구 사항이 없습니다. 즉, KMD는 하드웨어 구현에 따라 여러 논리 초인종/하드웨어 큐와 동일한 물리적 주소를 공유하도록 선택할 수 있습니다. 예를 들어 일부 하드웨어는 단일 하드웨어 컨텍스트의 모든 하드웨어 큐에 동일한 물리적 주소를 할당하도록 선택할 수 있습니다. 여러 논리 초인종이 동일한 4KB 실제 페이지를 공유하지만 페이지 내에서 고유한 오프셋을 사용할 수도 있습니다.
자세한 내용은 사용자 모드 작업 제출참조하세요.
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 11 버전 24H2(WDDM 3.2) |
헤더 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |