D3DKMTInvalidateActiveVidPn 函式 (d3dkmthk.h)
D3DKMTInvalidateActiveVidPn 函式會使作用中的影片呈現網路失效， (目前使用的 VidPN) 。
注意
此函式在 Windows 7 和更新版本的 Windows 作業系統中已過時。
語法
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
參數
[in] unnamedParam1
D3DKMT_INVALIDATEACTIVEVIDPN 結構的指標，描述使目前使用中 VidPN 失效的參數。
傳回值
D3DKMTInvalidateActiveVidPn 會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
| STATUS_SUCCESS | 目前使用的 VidPN 已成功失效。 |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | D3DKMT_INVALIDATEACTIVEVIDPN的 hAdapter 成員中未指定圖形適配 卡，使 VidPN 失效。 |
| STATUS_NO_MEMORY | D3DKMTInvalidateActiveVidPn 因為記憶體不足而無法完成。 |
| STATUS_NOT_SUPPORTED | 顯示迷你埠驅動程式不支援在 pPrivateDriverData 成員所指向的緩衝區中，OpenGL 可安裝用戶端驅動程式所要求的顯示模式 (ICD D3DKMT_INVALIDATEACTIVEVIDPN) 。 如果執行 Windows 7 和更新版本的電腦上呼叫此函式， >DXGKDDI_INTERFACE_VERSION = DXGKDDI_INTERFACE_VERSION_WIN7，也會傳回此狀態值。 |
| STATUS_DEVICE_REMOVED | 圖形配接器已停止。 |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | 顯示迷你埠驅動程序不建議使用 VidPN 來取代目前使用的 VidPN。 |
此函式也可能傳回其他 NTSTATUS 值。
備註
當呼叫 D3DKMTInvalidateActiveVidPn 函式來使目前使用的 VidPN 失效時，目前的 VidPN 會取代為顯示迷你埠驅動程序建議的新 VidPN。 因為顯示迷你埠驅動程序必須建議新的 VidPN，所以顯示迷你埠驅動程式必須能夠判斷 OpenGL ICD 從 pPrivateDriverData 成員所指向的緩衝區D3DKMT_INVALIDATEACTIVEVIDPN所需的顯示模式。
OpenGL ICD 可以針對顯示模式呼叫 D3DKMTInvalidateActiveVidPn (，例如，使用較一般呼叫 D3DKMTSetDisplayMode 函式不支援的複製檢視模式) 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用，以使用版本 < DXGKDDI_INTERFACE_VERSION_WIN7來顯示迷你埠驅動程式。 |
| 目標平台 | Universal |
| 標頭 | d3dkmthk.h (包含 D3dkmthk.h) |
| 程式庫 | Gdi32.lib |
| Dll | Gdi32.dll |