DXGKDDI_SETPOINTERPOSITION回呼函式 (d3dkmddi.h)

發行項
02/25/2024

DxgkDdiSetPointerPosition 函式會設定滑鼠指標的位置和可見性狀態。

語法

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

NTSTATUS DxgkddiSetpointerposition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERPOSITION pSetPointerPosition
)
{...}

參數

[in] hAdapter

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 Microsoft DirectX 圖形核心子系統。

[in] pSetPointerPosition

DXGKARG_SETPOINTERPOSITION 結構的指標，描述滑鼠指標的位置和顯示方式。

傳回值

如果成功，DxgkDdiSetPointerPosition 會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

備註

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

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

即使影片呈現網路 (VidPN) 拓撲，也可以呼叫 DxgkDdiSetPointerPosition，該拓撲與 pSetPointerPosition 參數指向之DXGKARG_SETPOINTERPOSITION結構的 VidPnSourceId 成員相關聯。在此情況下，驅動程式應該會傳回STATUS_SUCCESS，但應該不會變更驅動程式或硬體的狀態。

DxgkDdiSetPointerPosition 應設為可分頁。