共用方式為


DXGKDDI_SETPOINTERPOSITION回呼函式 (d3dkmddi.h)

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

語法

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

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

參數

[in] hAdapter

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

[in] pSetPointerPosition

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

傳回值

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

言論

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

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

DxgkDdiSetPointerPosition,即使 pSetPointerPosition 參數指向的 VidPnSourceIdDXGKARG_SETPOINTERPOSITION 成員相關聯的影片呈現網路 (VidPN) 拓撲也一樣。 在此情況下,驅動程式應該傳回STATUS_SUCCESS,但應該不會變更驅動程式或硬體的狀態。

DxgkDdiSetPointerPosition 應設為可分頁。

要求

要求 價值
最低支援的用戶端 Windows Vista
目標平臺 桌面
標頭 d3dkmddi.h (包括 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另請參閱

DXGKARG_SETPOINTERPOSITION

DxgkDdiAddDevice

DxgkDdiSetPointerShape