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

DxgkDdiControlInterrupt 関数は、グラフィックス ハードウェアで特定の割り込みの種類を有効または無効にします。

構文

DXGKDDI_CONTROLINTERRUPT DxgkddiControlinterrupt;

NTSTATUS DxgkddiControlinterrupt(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_DXGK_INTERRUPT_TYPE InterruptType,
  [in] IN_BOOLEAN EnableInterrupt
)
{...}

パラメーター

[in] hAdapter

グラフィックス処理装置 (GPU) のアダプター オブジェクトへのハンドル。 ドライバーは、DxgkDdiAddDevice 関数の呼び出しから、ミニポートDeviceContext パラメーターでこのハンドルを返しました。

[in] InterruptType

割り込み型を提供する DXGK_INTERRUPT_TYPE型の値。

[in] EnableInterrupt

DxgkDdiControlInterrupt 指定した割り込みの種類を有効または無効にするかどうかを示すブール値。 TRUE は有効であることを示し、FALSE 無効にすることを示します。

戻り値

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

リターン コード	形容
STATUS_SUCCESS	割り込みの種類は、グラフィックス ハードウェアで正常に有効または無効になりました。
STATUS_NOT_IMPLEMENTED	DxgkDdiControlInterrupt は、指定した割り込みタイプの有効化または無効化をサポートしていません。

備考

ディスプレイ ミニポート ドライバーの DxgkDdiControlInterrupt 関数は、指定した割り込みの種類を有効または無効にすることができます。 ただし、ドライバー 内部目的で割り込みの種類が必要な場合、DxgkDdiControlInterrupt は割り込みの種類を無効にする必要はありません。 指定した割り込みの種類 DxgkDdiControlInterrupt を呼び出すと、オペレーティング システムで、グラフィックス ハードウェアで割り込みの種類がトリガーされたときにレポートする DxgkCbNotifyInterrupt 関数を呼び出す必要があることを示します。

現在、Microsoft DirectX グラフィックス カーネル サブシステムでは、InterruptType パラメーターにDXGK_INTERRUPT_CRTC_VSYNC割り込みの種類のみが指定されています。 dxgkDdiControlInterrupt を呼び出して、DXGK_INTERRUPT_CRTC_VSYNC割り込みの種類を有効にすると、ドライバーが垂直方向のトレース割り込みを制御することを示します。 すべての垂直リトレース期間中、および DAC レジスタで指定されたプライマリ サーフェス アドレスがラッチされてスキャンアウトされた直後に、割り込みをトリガーして報告する必要があります。

DXGK_INTERRUPT_CRTC_VSYNC以外の割り込みの種類が指定されている場合、ドライバーはSTATUS_NOT_IMPLEMENTEDを返す必要があります。

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

必要条件

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

関連項目

DXGK_INTERRUPT_TYPE

DxgkCbNotifyInterrupt を する

DxgkDdiAddDevice の