DXGKDDI_LINK_DEVICE fonction de rappel (dispmprt.h)

La fonction DxgkDdiLinkDevice facultative interroge le pilote miniport d’affichage pour obtenir des 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 une carte d’affichage.

[in] MiniportDeviceContext

Handle d’un bloc de contexte associé à une carte d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait précédemment cette poignée au sous-système du noyau graphique Microsoft DirectX.

[in, out] LinkedDevice

Pointeur vers une structure de LINKED_DEVICE qui contient des informations sur la configuration de l’adaptateur d’affichage lié.

Valeur retournée

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 des cartes d’affichage qui prennent en charge les cartes d’affichage liées.

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 un appel à 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 VGA.

Le pilote ne peut énumérer qu’un seul lien principal dans la chaîne de cartes d’affichage liées.

Plug-and-Play ou les événements d’alimentation entraînent l’alimentation ou le démarrage de l’adaptateur lié de premier plan après les adaptateurs liés restants ou, à l’inverse, de tels événements entraînent la mise hors tension ou la désactivation de l’adaptateur lié de premier plan avant les cartes liées restantes.

Configuration requise

Voir aussi

DxgkDdiAddDevice

LINKED_DEVICE