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 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 |