DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE función de devolución de llamada (d3dkmddi.h)
La función pfnEnumPathTargetsFromSource devuelve el identificador de uno de los destinos presentes de vídeo asociados a un origen de vídeo presente especificado.
Sintaxis
DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE DxgkddiVidpntopologyEnumpathtargetsfromsource;
NTSTATUS DxgkddiVidpntopologyEnumpathtargetsfromsource(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DKMDT_VIDPN_PRESENT_PATH_INDEX VidPnPresentPathIndex,
[out] OUT_PD3DDDI_VIDEO_PRESENT_TARGET_ID pVidPnTargetId
)
{...}
Parámetros
[in] hVidPnTopology
Identificador de un objeto de topología VidPN. El controlador de miniporte de pantalla obtuvo anteriormente este identificador llamando a la función pfnGetTopology de la interfaz DXGK_VIDPN_INTERFACE .
[in] VidPnSourceId
Entero que identifica un origen de presentación de vídeo determinado.
[in] VidPnPresentPathIndex
Índice de base cero en el conjunto de rutas de acceso que contienen el origen identificado por VidPnSourceId.
[out] pVidPnTargetId
Puntero a una variable que recibe el identificador de destino.
Valor devuelto
La función pfnEnumPathTargetsFromSource 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 pVidPnTargetId estaba en válido. |
Comentarios
VidPnPresentPathIndex no es un índice en el conjunto de todas las rutas de acceso de la topología identificadas por hVidPnTopology. Es un índice en un subconjunto de todas las rutas de acceso de la topología: en concreto, el subconjunto de todas las rutas de acceso que contienen el origen identificado por VidPnSourceId.
Para enumerar (en una topología determinada) todos los destinos asociados a un origen determinado, realice los pasos siguientes.
Llame a pfnGetNumPathsFromSource para determinar el número N de rutas de acceso que contienen el origen de interés. Piense en esas rutas de acceso como un conjunto indizado con índices 0, 1, ... N - 1.
Para cada índice 0 aunque N - 1, pase el identificador de origen y el índice a pfnEnumPathTargetsFromSource.
Una topología es una ruta de acceso de colección, cada una de las cuales contiene un par (origen, destino). Es posible que un origen determinado aparezca en más de una ruta de acceso. Por ejemplo, un origen se puede emparejar con dos destinos distintos en el caso de una vista clonada.
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 visualización asigna identificadores de destino VidPN. DxgkDdiQueryChildRelations, implementado por el controlador de miniporte de pantalla, devuelve una matriz de estructuras de DXGK_CHILD_DESCRIPTOR , cada una de las cuales contiene un identificador.
Los tipos de datos D3DKMDT_HVIDPNTOPOLOGY y D3DKMDT_VIDPN_PRESENT_PATH_INDEX se definen en D3dkmdt.h.
Los tipos de datos D3DDDI_VIDEO_PRESENT_SOURCE_ID y 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 (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |