Compartir a través de


DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO función de devolución de llamada (d3dkmddi.h)

La función pfnAcquirePathInfo devuelve un descriptor de la ruta de acceso presente de vídeo 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 minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnGetTopology de la interfaz DXGK_VIDPN_INTERFACE .

[in] VidPnSourceId

Entero que identifica un origen de vídeo presente.

[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 valores siguientes:

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.

Comentarios

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 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 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 (incluya D3dkmddi.h)
IRQL PASSIVE_LEVEL

Consulte también

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo

pfnReleasePathInfo