DXGKDDI_LINK_DEVICE fonction de rappel (dispmprt.h)

  • Article

La fonction facultative DxgkDdiLinkDevice 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 de périphérique physique (PDO) qui identifie une carte graphique.

[in] MiniportDeviceContext

Handle d’un bloc de contexte associé à un adaptateur d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage a 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 la carte graphique liée.

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 graphiques qui prennent en charge les cartes graphiques liées.

Si cette fonction est fournie, le système d’exploitation interroge le pilote de 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 graphiques 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 de début dans la chaîne de cartes graphiques liées.

Plug-and-Play ou les événements d’alimentation provoquent l’alimentation ou le démarrage de l’adaptateur lié de début après les adaptateurs liés restants, ou, à l’inverse, ces événements entraînent la mise hors tension ou la désactivation de l’adaptateur lié principal avant les adaptateurs liés restants.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h
IRQL PASSIVE_LEVEL

Voir aussi

DxgkDdiAddDevice

LINKED_DEVICE