DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE fonction de rappel (d3dkmddi.h)
La fonction pfnGetNumPathsFromSource retourne le nombre de chemins d’accès vidéo présents qui contiennent une source de vidéo spécifiée.
Syntaxe
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
)
{...}
Paramètres
[in] hVidPnTopology
Handle vers un objet de topologie VidPN. Le pilote miniport d’affichage a obtenu précédemment ce handle en appelant la fonction pfnGetTopology de l’interface DXGK_VIDPN_INTERFACE.
[in] VidPnSourceId
Entier qui identifie une vidéo particulière présente la source.
[out] pNumPathsFromSource
Pointeur vers une variable typée SIZE_T qui reçoit le nombre de chemins d’accès qui contiennent la source spécifiée.
Valeur de retour
La fonction pfnGetNumPathsFromSource retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | La fonction a réussi. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | Le handle fourni dans hVidPnTopology n’était pas valide. |
| STATUS_INVALID_PARAMETER | Le pointeur fourni dans pNumPathsFromSource était valide. |
Remarques
Une topologie est un chemin d’accès de collection, chacun contenant une paire (source, cible). Il est possible qu’une source particulière apparaisse dans plusieurs chemins d’accès. Par exemple, une source peut être jumelée à deux cibles distinctes dans le cas d’une vue clone.
Les identificateurs sources VidPN sont attribués par le système d’exploitation. DxgkDdiStartDevice, implémenté par le pilote de miniport d’affichage, retourne le nombre N de sources présentes vidéo prises en charge par l’adaptateur d’affichage. Ensuite, le système d’exploitation attribue des identificateurs 0, 1, 2, ... N - 1.
Le type de données D3DKMDT_HVIDPNTOPOLOGY est défini dans D3dkmdt.h .
Le type de données D3DDDI_VIDEO_PRESENT_SOURCE_ID est défini dans D3dukmdt.h.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |