DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO función de devolución de llamada (d3dkmddi.h)
La función pfnAcquirePathInfo devuelve un descriptor de la ruta de acceso del vídeo presente especificada por un origen de vídeo presente y un destino de vídeo presente dentro de una topología VidPN determinada.
Sintaxis
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
Parámetros
[in] hVidPnTopology
Identificador de un objeto de topología VidPN. El controlador de miniporte de pantalla obtuvo previamente este identificador llamando a la función pfnGetTopology de de la interfaz DXGK_VIDPN_INTERFACE.
[in] VidPnSourceId
Entero que identifica un origen de presentación de vídeo.
[in] VidPnTargetId
Entero que identifica un destino de vídeo presente.
[out] ppVidPnPresentPathInfo
Puntero a una variable que recibe un puntero a una estructura D3DKMDT_VIDPN_PRESENT_PATH que describe la ruta de acceso solicitada.
Valor devuelto
La función pfnAcquirePathInfo devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se realizó correctamente. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | El identificador proporcionado en hVidPnTopology no era válido. |
Observaciones
Cuando haya terminado de usar la estructura D3DKMDT_VIDPN_PRESENT_PATH, debe liberar la estructura llamando a pfnReleasePathInfo.
Una ruta de acceso contiene un par (origen, destino) y una topología es una colección de rutas de acceso. Esta función devuelve un descriptor para la ruta de acceso, en una topología especificada, que contiene un par especificado (origen, destino).
Puede enumerar todas las rutas de acceso que pertenecen a un objeto de topología VidPN llamando a pfnAcquireFirstPathInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextPathInfo.
El sistema operativo asigna los 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 miniporte de pantalla asigna los 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 y D3DDDI_VIDEO_PRESENT_TARGET_ID se definen en D3dukmdt.h .
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 |