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 |