DXGKDDI_CREATEDOORBELL 콜백 함수(d3dkmddi.h)

아티클
05/26/2023

중요

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

OS는 KMD의 DxgkDdiCreateDoorbell 콜백 함수를 호출하여 하드웨어 큐에 대한 초인종을 만듭니다.

구문

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

매개 변수

pArgs

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

반환 값

DxgkDdiCreateDoorbell 은 KMD가 지정된 하드웨어 큐에 대한 초인종 개체를 성공적으로 만들 수 있으면 STATUS_SUCCESS 반환하고 UMD는 작업 제출에 이 초인종을 사용할 수 있습니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드를 반환합니다. KMD가 오류 코드를 반환하는 경우 UMD는 작업 제출에 초인종을 사용할 수 없습니다.

설명

UMD가 D3DKMTCreateDoorbell 을 호출하여 하드웨어 큐에 대한 초인종을 만들 때 OS는 KMD가 초인종 구조를 초기화할 수 있도록 KMD에 해당하는 DxgkDdiCreateDoorbell 호출을 합니다.

KMD의 DxgkDdiCreateDoorbell 함수는 초인종 데이터 구조만 만들고 초기화해야 합니다. DxgkDdiConnectDoorbell에 대한 후속 호출 중에 수행되므로 이 초인종 개체에 물리적 초인종 위치를 할당해서는 안 됩니다. 이 지연 할당은 하드웨어 큐 및 초인종을 만드는 동안 물리적 초인종을 사용하지 않고 UMD가 명령을 제출하지 않거나 나중에 명령 제출을 시작하는 경우에만 낭비됩니다. 이러한 방식으로 실제 초인종은 실제로 필요한 경우에만 사용됩니다.