DXGKDDI_RECOMMENDFUNCTIONALVIDPN - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// d3dkmddi.h

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nc-d3dkmddi-dxgkddi_recommendfunctionalvidpn)

DXGKDDI_RECOMMENDFUNCTIONALVIDPN callback function

Description

The DxgkDdiRecommendFunctionalVidPn function creates a functional VidPN that can be implemented on a specified display adapter.

Parameters

hAdapter [in]

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.

pRecommendFunctionalVidPn [in]

A pointer to a DXGKARG_RECOMMENDFUNCTIONALVIDPN structure that contains function arguments. The caller supplies the hRecommendedFunctionalVidPn member, which is a handle to an empty VidPN object. DxgkDdiRecommendFunctionalVidPn populates the VidPN object with the elements of a functional VidPN: topology, mode sets, pinned modes.

Return value

DxgkDdiRecommendFunctionalVidPn returns one of the following values:

Return code Description
STATUS_SUCCESS The function succeeded in creating a functional VidPN.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN The function was not able to create a functional VidPN.
STATUS_NO_MEMORY The function failed because it was unable to allocate memory.

Remarks

A VidPN is functional if it satisfies the following conditions:

The job of DxgkDdiRecommendFunctionalVidPn is to create a functional VidPN that can be implemented on the display adapter. The following list gives the steps used to create a functional VidPN.

  1. Start with a handle to an empty VidPN object. This handle was supplied in the hDesiredVidPn member of pRecommendFunctionalVidPnArg.
  2. Add a path (source-target pair) to the topology of the VidPN.
  3. Create a new source mode set and add one source mode to the set. Assign the source mode set to the source in your path. Pin the source mode.
  4. Create a new target mode set and add one target mode to the set. Assign the target mode set to the target in your path. Pin the target mode.

For information about how to add paths, add mode sets, assign modes, and pin modes, see VidPN Objects and Interfaces.

DxgkDdiRecommendFunctionalVidPn should be made pageable.

View the official Windows Driver Kit DDI reference

Edit description on GitHub