DXGKDDI_LINK_DEVICE fonction de rappel (dispmprt.h)
Le facultatif DxgkDdiLinkDevice fonction interroge le pilote miniport d’affichage pour plus d’informations sur la configuration de l’adaptateur lié.
Syntaxe
DXGKDDI_LINK_DEVICE DxgkddiLinkDevice;
NTSTATUS DxgkddiLinkDevice(
[in] IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
[in] IN_CONST_PVOID MiniportDeviceContext,
[in, out] INOUT_PLINKED_DEVICE LinkedDevice
)
{...}
Paramètres
[in] PhysicalDeviceObject
Pointeur vers un objet d’appareil physique (PDO) qui identifie un adaptateur d’affichage.
[in] MiniportDeviceContext
Handle vers un bloc de contexte associé à un adaptateur d’affichage. La fonction d’affichage du pilote miniport DxgkDdiAddDevice précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX.
[in, out] LinkedDevice
Pointeur vers une structure LINKED_DEVICE qui contient des informations sur la configuration de l’adaptateur d’affichage lié.
Valeur de retour
DxgkDdiLinkDevice retourne STATUS_SUCCESS, ou un code d’erreur approprié si des informations sur la configuration de l’adaptateur lié ne peuvent pas être obtenues.
Remarques
La fonction DxgkDdiLinkDevice doit être implémentée par les pilotes d’adaptateurs d’affichage qui prennent en charge les adaptateurs d’affichage liés.
Si cette fonction est fournie, le système d’exploitation interroge le pilote miniport d’affichage pour la configuration de l’adaptateur lié immédiatement après qu’un appel est effectué pour DxgkDdiAddDevice.
Si le système d’exploitation n’énumère pas toutes les cartes d’affichage attendues dans la structure pointée par LinkedDevice, le système démarre en mode ODBC.
Le pilote ne peut énumérer qu’un seul lien de début dans la chaîne d’adaptateurs d’affichage liés.
Les événements Plug-and-Play ou d’alimentation entraînent la mise en tension ou le démarrage de l’adaptateur lié principal après les adaptateurs liés restants, ou, à l’inverse, l’adaptateur lié de premier plan est désactivé ou désactivé avant les adaptateurs liés restants.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | dispmprt.h |
| IRQL | PASSIVE_LEVEL |