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

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo

pfnReleasePathInfo