Windows Driver Kit: Display Devices
D3DKMTInvalidateActiveVidPn
The D3DKMTInvalidateActiveVidPn function invalidates the active video present network (VidPN) currently in use.
NTSTATUS
(APIENTRY *PFND3DKMT_INVALIDATEACTIVEVIDPN)(
__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:
- 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.
- 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.
Comments
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
Headers: Declared in D3dkmthk.h. Include D3dkmthk.h.
See Also
D3DKMT_INVALIDATEACTIVEVIDPN, D3DKMTSetDisplayMode