DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET función de devolución de llamada (d3dkmddi.h)
La función pfnGetPathSourceFromTarget devuelve el identificador del origen del vídeo presente asociado a un destino de vídeo presente especificado.
Sintaxis
DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;
NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}
Parámetros
[in] hVidTopology
Identificador de un objeto de topología VidPN. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnGetTopology de la interfaz DXGK_VIDPN_INTERFACE .
[in] VidPnTargetId
Entero que identifica un origen de presentación de vídeo determinado.
[out] pVidPnSourceId
Puntero a una variable que recibe el identificador del origen del vídeo presente.
Valor devuelto
La función pfnGetPathSourceFromTarget devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se ha realizado correctamente. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | El identificador proporcionado en hVidPnTopology no era válido. |
| STATUS_INVALID_PARAMETER | El puntero proporcionado en pVidPnSourceId estaba en válido. |
Comentarios
Una topología es una ruta de acceso de colección, cada una de las cuales contiene un par (origen, destino). Un destino determinado pertenece como máximo a una ruta de acceso, por lo que, dado un identificador de destino, hay como máximo un origen asociado a ese destino.
El sistema operativo asigna identificadores de origen vidPN. DxgkDdiStartDevice, implementado por el controlador de miniporte de pantalla, devuelve el número N de orígenes de vídeo presentes admitidos por el adaptador de pantalla. A continuación, el sistema operativo asigna identificadores 0, 1, 2, ... N - 1.
El controlador de minipuerto de pantalla asigna identificadores de destino VidPN. DxgkDdiQueryChildRelations, implementado por el controlador de miniporte de pantalla, devuelve una matriz de estructuras DXGK_CHILD_DESCRIPTOR , cada una de las cuales contiene un identificador.
El tipo de datos D3DKMDT_HVIDPNTOPOLOGY se define en D3dkmdt.h.
Los tipos de datos D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID se definen en D3dukmdt.h.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluya D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |