DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET fonction de rappel (d3dkmddi.h)
La fonction pfnGetPathSourceFromTarget retourne l’identificateur de la source actuelle de la vidéo associée à une cible présente vidéo spécifiée.
Syntaxe
DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;
NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}
Paramètres
[in] hVidTopology
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] VidPnTargetId
Entier qui identifie une vidéo particulière présente la source.
[out] pVidPnSourceId
Pointeur vers une variable qui reçoit l’identificateur de la vidéo présente la source.
Valeur de retour
La fonction pfnGetPathSourceFromTarget 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 pVidPnSourceId était valide. |
Remarques
Une topologie est un chemin d’accès de collection, chacun contenant une paire (source, cible). Une cible particulière appartient au plus un chemin d’accès. Par conséquent, étant donné un ID cible, il existe au plus une source associée à cette cible.
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.
Les identificateurs cibles VidPN sont attribués par le pilote miniport d’affichage. DxgkDdiQueryChildRelations, implémenté par le pilote miniport d’affichage, retourne un tableau de structures DXGK_CHILD_DESCRIPTOR, chacune contenant un identificateur.
Le type de données D3DKMDT_HVIDPNTOPOLOGY est défini dans D3dkmdt.h .
Les types de données D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID sont définis 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 |