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

Artículo
05/23/2024

La función pfnReleasePathInfo libera una estructura de D3DKMDT_VIDPN_PRESENT_PATH que el administrador vidPN proporcionó anteriormente al controlador de miniporte de pantalla.

Sintaxis

DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;

NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}

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

Puntero a la estructura D3DKMDT_VIDPN_PRESENT_PATH que se va a liberar.

Valor devuelto

La función pfnReleasePathInfo 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_GRAPHICS_INVALID_VIDPN_PRESENT_PATH	El puntero proporcionado en pVidPnPresentPathInfo no era válido.

Comentarios

Cuando haya terminado de usar una estructura de D3DKMDT_VIDPN_PRESENT_PATH que obtuvo llamando a cualquiera de las funciones siguientes, debe liberar la estructura llamando a pfnReleasePathInfo.

Si obtiene una estructura de D3DKMDT_VIDPN_PRESENT_PATH llamando a pfnCreateNewPathInfo y, a continuación, pasa esa estructura a pfnAddPath, no es necesario liberar la estructura.

Si obtiene un identificador llamando a pfnCreateNewPathInfo y decide no agregar la nueva ruta de acceso a una topología, debe liberar la estructura recién creada llamando a pfnReleasePathInfo.

El tipo de datos D3DKMDT_HVIDPNTOPOLOGY se define en D3dkmdt.h.