次の方法で共有


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

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

構文

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

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

パラメーター

[in] hAdapter

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

[in] pSetPointerShape

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

戻り値

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

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

注釈

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

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

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

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

要件

要件
サポートされている最小のクライアント Windows Vista
対象プラットフォーム デスクトップ
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

DXGKARG_SETPOINTERSHAPE

DxgkDdiAddDevice

DxgkDdiSetPointerPosition