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 miniport para mostrar llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, o DxgkDdiRecommendFunctionalVidPn.
[out] phVidPnTopology
Puntero a una variable que recibe un identificador del objeto de topología VidPN.
[out] ppVidPnTopologyInterface
Puntero a una variable que recibe un puntero a una estructura 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 siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se realizó correctamente. |
| STATUS_GRAPHICS_INVALID_VIDPN | El identificador proporcionado en hVidPn no era válido. |
Observaciones
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 | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h (incluya D3dkmddi.h) |
| irQL | PASSIVE_LEVEL |