DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO función de devolución de llamada (d3dkmddi.h)
La estructura pfnAcquireFirstPathInfo devuelve un descriptor de la primera ruta de acceso de un objeto de topología VidPN especificado.
Sintaxis
DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}
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 .
[out] ppFirstVidPnPresentPathInfo
Puntero a una variable que recibe un puntero a una estructura de D3DKMDT_VIDPN_PRESENT_PATH . La estructura contiene una variedad de información sobre la ruta de acceso, incluidos los identificadores de origen y destino de la ruta de acceso.
Valor devuelto
La función pfnAcquireFirstPathInfo 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. |
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluya D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |