DXGKDDI_VIDPN_GETTOPOLOGY fonction de rappel (d3dkmddi.h)
La fonction pfnGetTopology retourne un handle à l’objet de topologie VidPN contenu par un objet VidPN spécifié.
Syntaxe
DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;
NTSTATUS DxgkddiVidpnGettopology(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}
Paramètres
[in] hVidPn
Handle vers un objet VidPN. Le gestionnaire VidPN a précédemment fourni ce handle au pilote miniport d’affichage en appelant DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, ou DxgkDdiRecommendFunctionalVidPn.
[out] phVidPnTopology
Pointeur vers une variable qui reçoit un handle vers l’objet de topologie VidPN.
[out] ppVidPnTopologyInterface
Pointeur vers une variable qui reçoit un pointeur vers une structure DXGK_VIDPNTOPOLOGY_INTERFACE. La structure contient des pointeurs vers des fonctions que le pilote miniport d’affichage peut appeler pour inspecter et modifier l’objet de topologie VidPN.
Valeur de retour
La fonction pfnGetTopology retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | La fonction a réussi. |
| STATUS_GRAPHICS_INVALID_VIDPN | Le handle fourni dans hVidPn n’était pas valide. |
Remarques
Le pilote miniport d’affichage n’a pas besoin de libérer le handle qu’il reçoit dans phVidPnTopology.
La durée de vie de la structure DXGK_VIDPNTOPOLOGY_INTERFACE retournée dans ppVidPnTopologyInterface appartient au système d’exploitation. À l’aide de ce schéma de propriété, le système d’exploitation peut migrer vers des implémentations plus récentes au moment de l’exécution sans interrompre les clients de l’interface.
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 |