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

La función pfnGetTopology devuelve un identificador al objeto de topología VidPN contenido por 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 vidPN proporcionó anteriormente este identificador al controlador de miniporte para mostrar 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

   
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Header d3dkmddi.h (incluye D3dkmddi.h)
IRQL PASSIVE_LEVEL

Consulte también

DXGK_VIDPNTOPOLOGY_INTERFACE

Interfaz de topología vidPN