DXGKDDI_VIDPNTOPOLOGY_ADDPATH fonction de rappel (d3dkmddi.h)
La fonction pfnAddPath ajoute un chemin d’accès présent vidéo à un objet de topologie VidPN spécifié.
Syntaxe
DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;
NTSTATUS DxgkddiVidpntopologyAddpath(
[in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}
Paramètres
[in] hVidPnTopology
Handle d’un objet de topologie VidPN. Le pilote miniport d’affichage a précédemment obtenu ce handle en appelant la fonction pfnGetTopology de l’interface DXGK_VIDPN_INTERFACE .
[in] pVidPnPresentPath
Pointeur vers une structure D3DKMDT_VIDPN_PRESENT_PATH qui décrit le chemin d’accès. Le pilote de miniport d’affichage a précédemment obtenu ce pointeur en appelant pfnCreateNewPathInfo.
Valeur retournée
La fonction pfnAddPath retourne l’une des valeurs suivantes :
Code de retour | Description |
---|---|
STATUS_SUCCESS | La fonction a réussi. |
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | Le handle fourni dans hVidPnTopology n’était pas valide. |
STATUS_ACCESS_DENIED | Le chemin d’accès ne peut pas être supprimé dans le contexte de l’appel DDI actuel. |
Remarques
Pour ajouter un chemin d’accès à une topologie, le pilote miniport d’affichage effectue les étapes suivantes.
Appelez pfnCreateNewPathInfo pour obtenir un pointeur vers une structure D3DKMDT_VIDPN_PRESENT_PATH allouée par le gestionnaire VidPN.
Renseignez la structure D3DKMDT_VIDPN_PRESENT_PATH avec des informations sur le chemin d’accès, y compris les identificateurs source et cible de la vidéo présente.
Appelez pfnAddPath pour ajouter le chemin d’accès à une topologie.
Le gestionnaire VidPN alloue une structure D3DKMDT_VIDPN_PRESENT_PATH lorsque vous appelez pfnCreateNewPathInfo. Si vous ajoutez le chemin décrit par cette structure à une topologie, vous n’avez pas besoin de libérer explicitement la structure ; pfnAddPath le libère.
Si vous obtenez une structure D3DKMDT_VIDPN_PRESENT_PATH en appelant pfnCreateNewPathInfo et que vous décidez de ne pas ajouter ce chemin à une topologie, vous devez libérer explicitement la structure en appelant pfnReleasePathInfo.
Le type de données D3DKMDT_HVIDPNTOPOLOGY est défini dans D3dkmdt.h.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista |
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | d3dkmddi.h (inclure D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour