DXGKDDI_SETPOINTERSHAPE回呼函式 (d3dkmddi.h)

  • 發行項

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 會傳回下列其中一個值：

傳回碼 Description
STATUS_SUCCESS 已成功繪製滑鼠指標。
STATUS_NO_MEMORY DxgkDdiSetPointerShape 無法配置完成所需的記憶體。

備註

DirectX 圖形核心子系統會呼叫 display miniport 驅動程式的 DxgkDdiSetPointerShape 函式，以設定滑鼠指標的相關信息。 DxgkDdiSetPointerShape 函式會獨立於所有其他顯示迷你埠驅動程式函式之外呼叫。 因此， DxgkDdiSetPointerShape 線程可以與另一個顯示迷你埠驅動程序線程同時執行。 不過，系統會確保 DxgkDdiSetPointerShape 和 DxgkDdiSetPointerPosition 線程無法同時執行。

如果您同時執行 DxgkDdiSetPointerShape 線程與另一個顯示迷你埠驅動程式線程，則 display miniport 驅動程式應該能夠獨立地設計滑鼠指標硬體，例如透過直接記憶體存取傳送命令緩衝區的作業 (DMA) 至圖形硬體，使用記憶體對應 I/O (MMIO) 來程式設計圖形硬體的作業， 依此類故。

如果影片呈現 (與 pSetPointerShape 所指向之DXGKARG_SETPOINTERSHAPE結構之 VidPnSourceId 成員相關聯的 VidPN) 拓撲，則不會呼叫 DxgkDdiSetPointerShape。

DxgkDdiSetPointerShape 應設為可分頁。

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 桌面
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARG_SETPOINTERSHAPE

DxgkDdiAddDevice

DxgkDdiSetPointerPosition