DXGKDDI_VIDPNTOPOLOGY_ADDPATH función de devolución de llamada (d3dkmddi.h)
La función pfnAddPath agrega una ruta de acceso de vídeo presente a un objeto de topología VidPN especificado.
Sintaxis
DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;
NTSTATUS DxgkddiVidpntopologyAddpath(
[in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}
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] pVidPnPresentPath
Puntero a una estructura D3DKMDT_VIDPN_PRESENT_PATH que describe la ruta de acceso. El controlador de minipuerto de pantalla obtuvo anteriormente este puntero llamando a pfnCreateNewPathInfo.
Valor devuelto
La función pfnAddPath 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_ACCESS_DENIED | La ruta de acceso no se puede quitar en el contexto de la llamada DDI actual. |
Comentarios
Para agregar una ruta de acceso a una topología, el controlador de minipuerto para mostrar realiza los pasos siguientes.
Llame a pfnCreateNewPathInfo para obtener un puntero a una estructura de D3DKMDT_VIDPN_PRESENT_PATH asignada por el administrador de VidPN.
Rellene la estructura de D3DKMDT_VIDPN_PRESENT_PATH con información sobre la ruta de acceso, incluidos los identificadores de origen y de destino del vídeo.
Llame a pfnAddPath para agregar la ruta de acceso a una topología.
El administrador de VidPN asigna una estructura de D3DKMDT_VIDPN_PRESENT_PATH al llamar a pfnCreateNewPathInfo. Si agrega la ruta de acceso descrita por esa estructura a una topología, no es necesario liberar explícitamente la estructura; pfnAddPath lo libera.
Si obtiene una estructura de D3DKMDT_VIDPN_PRESENT_PATH llamando a pfnCreateNewPathInfo y decide no agregar esa ruta de acceso a una topología, debe liberar explícitamente la estructura llamando a pfnReleasePathInfo.
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 (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |