DXGKDDI_VIDPN_RELEASESOURCEMODESET callback function

The pfnReleaseSourceModeSet function releases a handle to a source mode set object.

Syntax


DXGKDDI_VIDPN_RELEASESOURCEMODESET pfnReleaseSourceModeSet;

NTSTATUS APIENTRY pfnReleaseSourceModeSet(
  _In_ const D3DKMDT_HVIDPN              hVidPn,
  _In_ const D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet
)
{ ... }

Parameters

hVidPn [in]

[in] A handle to the VidPN object that contains the source mode set object. The VidPN manager previously provided this handle to the display miniport driver by calling DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, or DxgkDdiRecommendFunctionalVidPn.

hVidPnSourceModeSet [in]

[in] The handle to be released.

Return value

The pfnReleaseSourceModeSet function returns one of the following values:

Return codeDescription
STATUS_SUCCESS

The function succeeded.

STATUS_GRAPHICS_INVALID_VIDPN

The handle supplied in hVidPn was invalid.

STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET

The handle supplied in hVidPnSourceModeSet was invalid.

STATUS_GRAPHICS_RESOURCES_NOT_RELATED

The VidPN identified by hVidPn does not contain the source mode set identified by hVidPnSourceModeSet.

 

Remarks

When you have finished using a handle that you obtained by calling pfnAcquireSourceModeSet, you must release the handle by calling pfnReleaseSourceModeSet.

If you obtain a handle by calling pfnCreateNewSourceModeSet and then pass that handle to pfnAssignSourceModeSet, you do not need to release the handle.

If you obtain a handle by calling pfnCreateNewSourceModeSet and then you decide not to assign the new source mode set to a source, you must release the newly obtained handle by calling pfnReleaseSourceModeSet.

The D3DKMDT_HVIDPN and D3DKMDT_HVIDPNSOURCEMODESET data types are defined in D3dkmdt.h.

Requirements

Target platform

Desktop

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

pfnAcquireSourceModeSet
pfnCreateNewSourceModeSet

 

 

Send comments about this topic to Microsoft

Show: