Edit

DXGKDDI_ISSUPPORTEDVIDPN callback function (d3dkmddi.h)

  • Article

The DxgkDdiIsSupportedVidPn function determines whether a specified VidPN is supported on a display adapter.

Syntax

DXGKDDI_ISSUPPORTEDVIDPN DxgkddiIssupportedvidpn;

NTSTATUS DxgkddiIssupportedvidpn(
  [in]      IN_CONST_HANDLE hAdapter,
  [in, out] INOUT_PDXGKARG_ISSUPPORTEDVIDPN pIsSupportedVidPn
)
{...}

Parameters

[in] hAdapter

A handle to a context block associated with a display adapter. The display miniport driver previously provided this handle to the DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

[in, out] pIsSupportedVidPn

A pointer to a DXGKARG_ISSUPPORTEDVIDPN structure. On input, the caller supplies the hDesiredVidPn member of the structure. On return, the IsVidPnSupported member receives a Boolean value that indicates whether the VidPN is supported (TRUE) or not supported (FALSE).

Return value

DxgkDdiIsSupportedVidPn returns one of the following values

Return code Description
STATUS_SUCCESS The topology of the VidPN is valid. The IsVidPnSupported structure member is set to either TRUE or FALSE.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY The topology of the VidPN implementation is invalid. The IsVidPnSupported structure member is set to FALSE.
STATUS_NO_MEMORY The function failed because it was unable to allocate memory.

Remarks

For more information about the analysis that this function must perform, see Determining Whether a VidPN is Supported on a Display Adapter.

If pIsSupportedVidPnArg->hDesiredVidPn is zero, DxgkDdiIsSupportedVidPn must set pIsSupportedVidPnArg->IsVidPnSupported to TRUE, the idea being that the display adapter can always be configured to display nothing.

DxgkDdiIsSupportedVidPn should be made pageable.

Requirements

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

See also

DxgkDdiEnumVidPnCofuncModality