DXGKDDI_SETPOINTERPOSITION fungsi panggilan balik (d3dkmddi.h)

Artikel
03/08/2023

Fungsi DxgkDdiSetPointerPosition mengatur lokasi dan status visibilitas penunjuk mouse.

Sintaks

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

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

Parameter

[in] hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX di parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

[in] pSetPointerPosition

Penunjuk ke struktur DXGKARG_SETPOINTERPOSITION yang menjelaskan di mana dan bagaimana menampilkan penunjuk mouse.

Menampilkan nilai

DxgkDdiSetPointerPosition mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Subsistem kernel grafis DirectX memanggil fungsi DxgkDdiSetPointerPosition driver miniport tampilan untuk mengatur lokasi penunjuk mouse. Fungsi DxgkDdiSetPointerPosition dipanggil secara independen dari semua fungsi driver miniport tampilan lainnya. Oleh karena itu, utas DxgkDdiSetPointerPosition dapat berjalan bersamaan dengan utas driver miniport tampilan lain. Namun, sistem memastikan bahwa utas DxgkDdiSetPointerPosition dan DxgkDdiSetPointerShape tidak dapat berjalan secara bersamaan.

Jika Anda menjalankan utas DxgkDdiSetPointerPosition secara bersamaan dengan utas driver miniport tampilan lain, driver miniport tampilan harus dapat memprogram perangkat keras penunjuk mouse secara independen dari aktivitas lain, seperti operasi yang mengirim buffer perintah melalui akses memori langsung (DMA) ke perangkat keras grafis, operasi yang memprogram perangkat keras grafis dengan menggunakan I/O yang dipetakan memori (MMIO), dan sebagainya.

DxgkDdiSetPointerPosition dapat dipanggil bahkan jika topologi video present network (VidPN) yang terkait dengan anggota VidPnSourceId dari struktur DXGKARG_SETPOINTERPOSITION yang dinonaktifkan oleh parameter pSetPointerPosition . Dalam hal ini, driver harus mengembalikan STATUS_SUCCESS tetapi tidak boleh membuat perubahan pada status driver atau perangkat keras.

DxgkDdiSetPointerPosition harus dibuat dapat dipaginasi.