D3DKMTInvalidateActiveVidPn 関数 (d3dkmthk.h)

D3DKMTInvalidateActiveVidPn 関数は、現在使用中のアクティブなビデオ 存在ネットワーク (VidPN) を無効にします。

注意

この関数は、Windows 7 以降のバージョンの Windows オペレーティング システムでは使用されていません。

構文

NTSTATUS D3DKMTInvalidateActiveVidPn(
  [in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);

パラメーター

[in] unnamedParam1

現在 使用中のアクティブ な VidPN を無効にするパラメーターを記述するD3DKMT_INVALIDATEACTIVEVIDPN構造体へのポインター。

戻り値

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

リターン コード	説明
STATUS_SUCCESS	現在使用中の VidPN は正常に無効になりました。
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	vidPN を無効にする D3DKMT_INVALIDATEACTIVEVIDPN の hAdapter メンバーにグラフィックス アダプターが指定されませんでした。
STATUS_NO_MEMORY	メモリ不足のため、D3DKMTInvalidateActiveVidPn を完了できませんでした。
STATUS_NOT_SUPPORTED	D3DKMT_INVALIDATEACTIVEVIDPNの pPrivateDriverData メンバーが指すバッファー内の OpenGL インストール可能クライアント ドライバー (ICD) によって要求される表示 モードは、 ディスプレイ ミニポート ドライバーではサポートされていません。 Windows 7 以降を実行しているコンピューターで、DXGKDDI_INTERFACE_VERSION = DXGKDDI_INTERFACE_VERSION_WIN7のディスプレイ ミニポート ドライバー >によってこの関数が呼び出された場合も、この状態値が返されます。
STATUS_DEVICE_REMOVED	グラフィックス アダプターが停止しました。
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN	ディスプレイ ミニポート ドライバーは、現在使用中の VidPN を置き換えるために VidPN を推奨しませんでした。

この関数は、他の NTSTATUS 値も 返す場合があります。

注釈

現在使用中の VidPN を無効にするために D3DKMTInvalidateActiveVidPn 関数が呼び出されると、現在の VidPN は、ディスプレイ ミニポート ドライバーが推奨する新しい VidPN に置き換えられます。 ディスプレイ ミニポート ドライバーは新しい VidPN を推奨する必要があるため、ディスプレイ ミニポート ドライバーは、OpenGL ICD が、D3DKMT_INVALIDATEACTIVEVIDPNの pPrivateDriverData メンバーが指すバッファーから必要な表示モードを決定できる必要があります。

OpenGL ICD は、D3DKMTSetDisplayMode 関数の一般的な呼び出しを使用してサポートされていない表示モード (複製ビュー モードなど) に対して D3DKMTInvalidateActiveVidPn を呼び出すことができます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティング システムで、バージョン < DXGKDDI_INTERFACE_VERSION_WIN7を備えたディスプレイ ミニポート ドライバーで使用できます。
対象プラットフォーム	ユニバーサル
Header	d3dkmthk.h (D3dkmthk.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

こちらもご覧ください

D3DKMTSetDisplayMode

D3DKMT_INVALIDATEACTIVEVIDPN