DXGKDDI_VIDPNTOPOLOGY_REMOVEPATH callback function (d3dkmddi.h)

The pfnRemovePath function removes a video present path to a specified VidPN topology object.

Syntax

DXGKDDI_VIDPNTOPOLOGY_REMOVEPATH DxgkddiVidpntopologyRemovepath;

NTSTATUS DxgkddiVidpntopologyRemovepath(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId
)
{...}

Parameters

[in] hVidPnTopology

A handle to a VidPN topology object. The display miniport driver previously obtained this handle by calling the pfnGetTopology function of the DXGK_VIDPN_INTERFACE interface.

[in] VidPnSourceId

An integer that identifies a VidPN source path.

[in] VidPnTargetId

An integer that identifies a VidPN target path.

Return value

The pfnRemovePath function returns one of the following values.

Return code Description
STATUS_SUCCESS The specified video present path has been successfully removed from this VidPN topology object.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE The VidPN source identifier supplied in VidPnSourceId is invalid.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET The VidPN target identifier supplied in VidPnTargetId is invalid.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY The handle supplied in hVidPnTopology is invalid.
STATUS_ACCESS_DENIED The path cannot be removed in the context of the current DDI call.

Remarks

The D3DKMDT_HVIDPNTOPOLOGY data type is defined in D3dkmdt.h.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Desktop
Header d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL