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

  • Artículo

La función pfnGetTopology devuelve un identificador al objeto de topología VidPN contenido en un objeto VidPN especificado.

Sintaxis

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

Parámetros

[in] hVidPn

Identificador de un objeto VidPN. El administrador de VidPN previamente proporcionó este identificador al controlador de minipuerto de pantalla llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[out] phVidPnTopology

Puntero a una variable que recibe un identificador para el objeto de topología VidPN.

[out] ppVidPnTopologyInterface

Puntero a una variable que recibe un puntero a una estructura de DXGK_VIDPNTOPOLOGY_INTERFACE . La estructura contiene punteros a funciones a las que el controlador de minipuerto de pantalla puede llamar para inspeccionar y modificar el objeto de topología VidPN.

Valor devuelto

La función pfnGetTopology devuelve uno de los valores siguientes:

Código devuelto Descripción
STATUS_SUCCESS La función se ha realizado correctamente.
STATUS_GRAPHICS_INVALID_VIDPN El identificador proporcionado en hVidPn no era válido.

Comentarios

El controlador de minipuerto de pantalla no necesita liberar el identificador que recibe en phVidPnTopology.

La duración de la estructura DXGK_VIDPNTOPOLOGY_INTERFACE devuelta en ppVidPnTopologyInterface es propiedad del sistema operativo. Con este esquema de propiedad, el sistema operativo puede migrar a implementaciones más recientes en tiempo de ejecución sin interrumpir los clientes de la interfaz.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Plataforma de destino Escritorio
Encabezado d3dkmddi.h (incluya D3dkmddi.h)
IRQL PASSIVE_LEVEL

Consulte también

DXGK_VIDPNTOPOLOGY_INTERFACE

Interfaz de topología vidPN