Edit

D3DKMTSetVidPnSourceOwner function (d3dkmthk.h)

  • Article

The D3DKMTSetVidPnSourceOwner function sets and releases the video present source in the path of a video present network (VidPN) topology that owns the VidPN.

Syntax

NTSTATUS D3DKMTSetVidPnSourceOwner(
  [in] const D3DKMT_SETVIDPNSOURCEOWNER *unnamedParam1
);

Parameters

[in] unnamedParam1

A pointer to a D3DKMT_SETVIDPNSOURCEOWNER structure that describes the parameters for setting or releasing.

Return value

D3DKMTSetVidPnSourceOwner returns one of the following values:

Return code Description
STATUS_SUCCESS The video present source was successfully set or released.
STATUS_DEVICE_REMOVED The graphics adapter was stopped or the display device was reset.
STATUS_GRAPHICS_VIDPN_SOURCE_IN_USE The video present source that is specified by an element in the array that the pVidPnSourceId member of D3DKMT_SETVIDPNSOURCEOWNER specifies is already owned by a display mode manager (DMM) client and cannot be used until the client releases the video present source.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE The video present source that is specified by an element in the array that the pVidPnSourceId member of D3DKMT_SETVIDPNSOURCEOWNER specifies is invalid.
STATUS_INVALID_PARAMETER Parameters were validated and determined to be incorrect.

This function might also return other NTSTATUS values.

Remarks

To set ownership of video present sources, the OpenGL installable client driver (ICD) sets values in the array that the pType member of the D3DKMT_SETVIDPNSOURCEOWNER structure specifies, identifiers of the video present sources in the array that the pVidPnSourceId member of D3DKMT_SETVIDPNSOURCEOWNER specifies, and the number of video present sources in the VidPnSourceCount member of D3DKMT_SETVIDPNSOURCEOWNER.

To release ownership of any video present sources, the ICD sets pType and pVidPnSourceId to NULL and VidPnSourceCount to zero in D3DKMT_SETVIDPNSOURCEOWNER.

The ICD passes a pointer to D3DKMT_SETVIDPNSOURCEOWNER in the pData parameter in a call to D3DKMTSetVidPnSourceOwner.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Universal
Header d3dkmthk.h (include D3dkmthk.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

D3DKMT_SETVIDPNSOURCEOWNER