Export (0) Print
Expand All
Expand Minimize

DxgkDdiSetPointerShape routine

The DxgkDdiSetPointerShape function sets the appearance and location of the mouse pointer.

Syntax


PDXGKDDI_SETPOINTERSHAPE DxgkDdiSetPointerShape;

NTSTATUS APIENTRY DxgkDdiSetPointerShape(
  _In_  const HANDLE hAdapter,
  _In_  const DXGKARG_SETPOINTERSHAPE *pSetPointerShape
)
{ ... }

Parameters

hAdapter [in]

[in] A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

pSetPointerShape [in]

[in] A pointer to a DXGKARG_SETPOINTERSHAPE structure that describes the appearance and location of the mouse pointer.

Return value

DxgkDdiSetPointerShape returns one of the following values:

Return codeDescription
STATUS_SUCCESS

The mouse pointer is successfully drawn.

STATUS_NO_MEMORY

DxgkDdiSetPointerShape could not allocate memory that was required for it to complete.

 

Remarks

The DirectX graphics kernel subsystem calls the display miniport driver's DxgkDdiSetPointerShape function to set information about the mouse pointer. The DxgkDdiSetPointerShape function is called independently of all of the other display miniport driver functions. Therefore, a DxgkDdiSetPointerShape thread can run simultaneously with another display miniport driver thread. However, the system ensures that DxgkDdiSetPointerShape and DxgkDdiSetPointerPosition threads cannot run simultaneously.

If you run a DxgkDdiSetPointerShape thread simultaneously with another display miniport driver thread, the display miniport driver should be able to program the mouse pointer hardware independently of other activities, such as operations that send a command buffer through direct memory access (DMA) to the graphics hardware, operations that program the graphics hardware by using memory-mapped I/O (MMIO), and so on.

DxgkDdiSetPointerShape is not called if the video present network (VidPN) topology that is associated with the VidPnSourceId member of the DXGKARG_SETPOINTERSHAPE structure that the pSetPointerShape parameter points to is disabled.

DxgkDdiSetPointerShape should be made pageable.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGKARG_SETPOINTERSHAPE
DxgkDdiAddDevice
DxgkDdiSetPointerPosition

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft