Compartir a través de

DXGKDDI_RECOMMENDFUNCTIONALVIDPN función de devolución de llamada (d3dkmddi.h)

  • Artículo

La función DxgkDdiRecommendFunctionalVidPn crea un VidPN funcional que se puede implementar en un adaptador de pantalla especificado.

Sintaxis

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}

Parámetros

[in] hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel gráfico de DirectX en la función MiniportDeviceContext parámetro de salida del DxgkDdiAddDevice función.

[in] pRecommendFunctionalVidPn

Puntero a una estructura DXGKARG_RECOMMENDFUNCTIONALVIDPN que contiene argumentos de función. El autor de la llamada proporciona el miembro hRecommendedFunctionalVidPn, que es un identificador de un objeto VidPN vacío. DxgkDdiRecommendFunctionalVidPn rellena el objeto VidPN con los elementos de una vidPN funcional: topología, conjuntos de modo, modos anclados.

Valor devuelto

dxgkDdiRecommendFunctionalVidPn devuelve uno de los siguientes valores:

Código devuelto Descripción
STATUS_SUCCESS La función se realizó correctamente al crear una VidPN funcional.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN La función no pudo crear una VidPN funcional.
STATUS_NO_MEMORY Error en la función porque no se pudo asignar memoria.

Observaciones

Un VidPN es funcional si cumple las condiciones siguientes:

  • Tiene una topología que tiene al menos una ruta de acceso. (Una ruta de acceso es una asociación entre un origen y un destino).
  • Cada origen y destino de la topología tiene un modo anclado.
El trabajo de DxgkDdiRecommendFunctionalVidPn es crear una VidPN funcional que se pueda implementar en el adaptador de pantalla. En la lista siguiente se proporcionan los pasos que se usan para crear una VidPN funcional.
  1. Comience con un identificador para un objeto VidPN vacío. Este identificador se proporcionó en el miembro hDesiredVidPn de pRecommendFunctionalVidPnArg.
  2. Agregue una ruta de acceso (par de destino de origen) a la topología de VidPN.
  3. Cree un nuevo conjunto de modos de origen y agregue un modo de origen al conjunto. Asigne el modo de origen establecido en el origen en la ruta de acceso. Ancle el modo de origen.
  4. Cree un nuevo conjunto de modos de destino y agregue un modo de destino al conjunto. Asigne el modo de destino establecido en el destino en la ruta de acceso. Ancle el modo de destino.
Para obtener información sobre cómo agregar rutas de acceso, agregar conjuntos de modo, asignar modos y modos de anclaje, vea VidPN Objects and Interfaces.

dxgkDdiRecommendFunctionalVidPn debe ser paginable.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista
de la plataforma de destino de Escritorio
encabezado de d3dkmddi.h
irQL PASSIVE_LEVEL