Expand Minimize

D3DKMTInvalidateActiveVidPn function

The D3DKMTInvalidateActiveVidPn function invalidates the active video present network (VidPN) currently in use.

Note   This function is obsolete in Windows 7 and later versions of the Windows operating systems.

Syntax


NTSTATUS D3DKMTInvalidateActiveVidPn(
  _In_  const D3DKMT_INVALIDATEACTIVEVIDPN *pData
);

Parameters

pData [in]

A pointer to a D3DKMT_INVALIDATEACTIVEVIDPN structure that describes parameters that invalidate the active VidPN currently in use.

Return value

D3DKMTInvalidateActiveVidPn returns one of the following values:

Return codeDescription
STATUS_SUCCESS

The VidPN currently in use was successfully invalidated.

STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER

No graphics adapter was specified in the hAdapter member of D3DKMT_INVALIDATEACTIVEVIDPN to invalidate the VidPN for.

STATUS_NO_MEMORY

D3DKMTInvalidateActiveVidPn could not complete because of insufficient memory.

STATUS_NOT_SUPPORTED

The display mode that is requested by the OpenGL installable client driver (ICD) in the buffer pointed to by the pPrivateDriverData member of D3DKMT_INVALIDATEACTIVEVIDPN is not supported by the display miniport driver.

This status value will also be returned if this function is called on a computer running Windows 7 and later by a display miniport driver with DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7.

STATUS_DEVICE_REMOVED

The graphics adapter was stopped.

STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN

The display miniport driver did not recommend a VidPN to replace the VidPN currently in use.

 

This function might also return other NTSTATUS values.

Remarks

When the D3DKMTInvalidateActiveVidPn function is called to invalidate the VidPN currently in use, the current VidPN is replaced with a new VidPN that the display miniport driver recommends. Because the display miniport driver must recommend a new VidPN, the display miniport driver must be able to determine the display mode that the OpenGL ICD requires from the buffer pointed to by the pPrivateDriverData member of D3DKMT_INVALIDATEACTIVEVIDPN.

The OpenGL ICD can call D3DKMTInvalidateActiveVidPn for display modes (for example, clone-view mode) that are not supported by using the more general call to the D3DKMTSetDisplayMode function.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems for display miniport drivers with version < DXGKDDI_INTERFACE_VERSION_WIN7.

Header

D3dkmthk.h (include D3dkmthk.h)

Library

Gdi32.lib

See also

D3DKMT_INVALIDATEACTIVEVIDPN
D3DKMTSetDisplayMode

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft