DXGKDDI_CREATEDOORBELL 콜백 함수(d3dkmddi.h)

아티클
05/23/2024

중요

일부 정보는 상용 출시 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. 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가 명령을 제출하지 않거나 나중에 명령 제출을 시작하는 경우에만 낭비됩니다. 이러한 방식으로 실제 초인종은 실제로 필요한 경우에만 사용됩니다.

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