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

La función pfnGetNumPathsFromSource devuelve el número de rutas de acceso de vídeo presentes que contienen un origen de vídeo presente especificado.

Sintaxis

DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE DxgkddiVidpntopologyGetnumpathsfromsource;

NTSTATUS DxgkddiVidpntopologyGetnumpathsfromsource(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PSIZE_T pNumPathsFromSource
)
{...}

Parámetros

[in] hVidPnTopology

Identificador de un objeto de topología VidPN. El controlador de miniporte de pantalla obtuvo previamente este identificador llamando a la función pfnGetTopology de de la interfaz DXGK_VIDPN_INTERFACE.

[in] VidPnSourceId

Entero que identifica un origen de presentación de vídeo determinado.

[out] pNumPathsFromSource

Puntero a una variable con tipo SIZE_T que recibe el número de rutas de acceso que contienen el origen especificado.

Valor devuelto

La función pfnGetNumPathsFromSource devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	La función se realizó correctamente.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	El identificador proporcionado en hVidPnTopology no era válido.
STATUS_INVALID_PARAMETER	El puntero proporcionado en pNumPathsFromSource estaba en válido.

Observaciones

Una topología es una ruta de acceso de colección, cada una de las cuales contiene un par (origen, destino). Es posible que un origen determinado aparezca en más de una ruta de acceso. Por ejemplo, un origen se puede emparejar con dos destinos distintos en el caso de una vista de clonación.

El sistema operativo asigna los 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 tipo de datos D3DKMDT_HVIDPNTOPOLOGY se define en D3dkmdt.h.

El tipo de datos D3DDDI_VIDEO_PRESENT_SOURCE_ID se define en D3dukmdt.h.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
de la plataforma de destino de	Escritorio
encabezado de	d3dkmddi.h (incluya D3dkmddi.h)
irQL	PASSIVE_LEVEL

Consulte también

pfnGetNumPaths