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 関数の呼び出しから、MiniportDeviceContext パラメーターでこのハンドルを返しました。
[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割 り込み タイプのみが指定されています。 DXGK_INTERRUPT_CRTC_VSYNC割り込みの種類を有効にする DxgkDdiControlInterrupt の呼び出しは、ドライバーが垂直方向のトレース割り込みを制御することを示します。 垂直方向のすべてのリトレース期間中、および DAC レジスタで指定されたプライマリ サーフェス アドレスがラッチされてスキャンアウトされた直後に、割り込みをトリガーして報告する必要があります。
DXGK_INTERRUPT_CRTC_VSYNC以外の割り込みの種類が指定されている場合、ドライバーはSTATUS_NOT_IMPLEMENTEDを返す必要があります。
DxgkDdiControlInterrupt をページング可能にする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |