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

Artículo
02/23/2024

La función pfnAcquireNextPathInfo devuelve un descriptor de la siguiente ruta de acceso presente de vídeo en una topología VidPN especificada, dada la ruta de acceso actual.

Sintaxis

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}

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] pVidPnPresentPathInfo

Puntero a una estructura D3DKMDT_VIDPN_PRESENT_PATH que describe la ruta de acceso actual. El controlador de minipuerto de pantalla obtuvo previamente este puntero llamando a pfnAcquireFirstPathInfo o pfnAcquireNextPathInfo.

[out] ppNextVidPnPresentPathInfo

Puntero a una variable que recibe un puntero a una estructura de D3DKMDT_VIDPN_PRESENT_PATH que describe la siguiente ruta de acceso.

Valor devuelto

La función pfnAcquireNextPathInfo 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.

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 tipo de datos D3DKMDT_HVIDPNTOPOLOGY se define en D3dkmdt.h.