DXGKDDI_SETPOINTERSHAPE fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi DxgkDdiSetPointerShape mengatur tampilan dan lokasi penunjuk mouse.

Sintaks

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

NTSTATUS DxgkddiSetpointershape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERSHAPE pSetPointerShape
)
{...}

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] pSetPointerShape

Penunjuk ke struktur DXGKARG_SETPOINTERSHAPE yang menjelaskan tampilan dan lokasi penunjuk mouse.

Menampilkan nilai

DxgkDdiSetPointerShape mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Penunjuk mouse berhasil digambar.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.

Keterangan

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

Jika Anda menjalankan utas DxgkDdiSetPointerShape 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.

DxgkDdiSetPointerShape tidak dipanggil jika topologi video present network (VidPN) yang terkait dengan anggota VidPnSourceId dari struktur DXGKARG_SETPOINTERSHAPE yang dinonaktifkan oleh parameter pSetPointerShape .

DxgkDdiSetPointerShape harus dibuat dapat dipaginasi.