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 miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

[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 modos, modos anclados.

Valor devuelto

DxgkDdiRecommendFunctionalVidPn devuelve uno de los siguientes valores:

Código devuelto Descripción
STATUS_SUCCESS La función se creó correctamente en la creación de 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 pudo asignar memoria.

Comentarios

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 un 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 modo 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 modo de destino y agregue un modo de destino al conjunto. Asigne el modo de destino establecido al 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 Value
Cliente mínimo compatible Windows Vista
Plataforma de destino Escritorio
Encabezado d3dkmddi.h
IRQL PASSIVE_LEVEL