DXGKDDI_SETPOINTERSHAPE コールバック関数 (d3dkmddi.h)

DxgkDdiSetPointerShape 関数は、マウス ポインターの外観と位置を設定します。

構文

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

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

パラメーター

[in] hAdapter

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiAddDevice 関数の出力パラメーター ミニポートDeviceContext の Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

[in] pSetPointerShape

マウス ポインターの外観と位置を記述する DXGKARG_SETPOINTERSHAPE 構造体へのポインター。

戻り値

DxgkDdiSetPointerShape は、次のいずれかの値を返します。

リターン コード	形容
STATUS_SUCCESS	マウス ポインターが正常に描画されました。
STATUS_NO_MEMORY	DxgkDdiSetPointerShape は、完了するために必要なメモリを割り当てませんでした。

備考

DirectX グラフィックス カーネル サブシステムは、ディスプレイ ミニポート ドライバーの DxgkDdiSetPointerShape 関数を呼び出して、マウス ポインターに関する情報を設定します。 DxgkDdiSetPointerShape 関数は、他のすべてのディスプレイ ミニポート ドライバー関数とは別に呼び出されます。 そのため、DxgkDdiSetPointerShape スレッドは、別のディスプレイ ミニポート ドライバー スレッドと同時に実行できます。 ただし、DxgkDdiSetPointerShape と DxgkDdiSetPointerPosition スレッド 同時に実行できないことがシステムによって保証されます。

DxgkDdiSetPointerShape スレッドを別のディスプレイ ミニポート ドライバー スレッドと同時に実行する場合、ディスプレイ ミニポート ドライバーは、グラフィックス ハードウェアへの直接メモリ アクセス (DMA) を介してコマンド バッファーを送信する操作、メモリ マップされた I/O (MMIO) を使用してグラフィックス ハードウェアをプログラムする操作など、他のアクティビティとは別にマウス ポインター ハードウェアをプログラムできる必要があります。 などなど。

DxgkDdiSetPointerShape は、pSetPointerShape パラメーターが指す DXGKARG_SETPOINTERSHAPE 構造体の VidPnSourceId メンバーに関連付けられているビデオ 提示ネットワーク (VidPN) トポロジが無効になっている場合は呼び出されません。

DxgkDdiSetPointerShape ページング可能にする必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h
IRQL	PASSIVE_LEVEL

関連項目

DXGKARG_SETPOINTERSHAPE

DxgkDdiAddDevice の

DxgkDdiSetPointerPosition の