DXGKDDI_SETPOINTERSHAPE 콜백 함수(d3dkmddi.h)

아티클
05/26/2023

DxgkDdiSetPointerShape 함수는 마우스 포인터의 모양과 위치를 설정합니다.

구문

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

NTSTATUS DxgkddiSetpointershape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERSHAPE pSetPointerShape
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Microsoft DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in] pSetPointerShape

마우스 포인터의 모양과 위치를 설명하는 DXGKARG_SETPOINTERSHAPE 구조체에 대한 포인터입니다.

반환 값

DxgkDdiSetPointerShape 는 다음 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	마우스 포인터가 성공적으로 그려집니다.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape에서 완료하는 데 필요한 메모리를 할당할 수 없습니다.

설명

DirectX 그래픽 커널 하위 시스템은 디스플레이 미니포트 드라이버의 DxgkDdiSetPointerShape 함수를 호출하여 마우스 포인터에 대한 정보를 설정합니다. DxgkDdiSetPointerShape 함수는 다른 모든 디스플레이 미니포트 드라이버 함수와 독립적으로 호출됩니다. 따라서 DxgkDdiSetPointerShape 스레드는 다른 디스플레이 미니포트 드라이버 스레드와 동시에 실행할 수 있습니다. 그러나 시스템은 DxgkDdiSetPointerShape 및 DxgkDdiSetPointerPosition 스레드를 동시에 실행할 수 없도록 합니다.

DxgkDdiSetPointerShape 스레드를 다른 디스플레이 미니포트 드라이버 스레드와 동시에 실행하는 경우 디스플레이 미니포트 드라이버는 DMA(직접 메모리 액세스)를 통해 명령 버퍼를 그래픽 하드웨어로 보내는 작업, 메모리 매핑 I/O(MMIO)를 사용하여 그래픽 하드웨어를 프로그래밍하는 작업과 같은 다른 작업과 독립적으로 마우스 포인터 하드웨어를 프로그래밍할 수 있어야 합니다. 등등.

pSetPointerShape 매개 변수가 가리키는 DXGKARG_SETPOINTERSHAPE 구조체의 VidPnSourceId 멤버와 연결된 VidPN(비디오 제공 네트워크) 토폴로지를 사용하지 않도록 설정하면 DxgkDdiSetPointerShape가 호출되지 않습니다.

DxgkDdiSetPointerShape 를 페이징 가능으로 만들어야 합니다.