PINTERFACE_REFERENCE fonction de rappel (wdm.h)

Article
02/27/2024

La routine InterfaceReference incrémente le nombre de références sur une interface définie par le pilote.

Syntaxe

PINTERFACE_REFERENCE PinterfaceReference;

void PinterfaceReference(
  [in] PVOID Context
)
{...}

Paramètres

[in] Context

Pointeur vers des informations de contexte spécifiques à l’interface. L’appelant transmet la valeur qui est passée en tant que membre de contexte de la structure INTERFACE pour l’interface.

Valeur de retour

None

Remarques

Notez qu’il s’agit d’un contrat par interface, il n’existe donc aucune exigence IRQL générale concernant InterfaceReference/Dereference.

Vous pouvez utiliser la routine InterfaceDereference pour décrémenter le nombre de références pour l’interface.

Le pilote qui exporte l’interface est chargé d’appeler InterfaceReference pour incrémenter le nombre de références avant que le pilote exporte l’interface. Par exemple, le pilote qui a initialement exporté l’interface en réponse à une demande de IRP_MN_QUERY_INTERFACE appelle InterfaceReference. En outre, un pilote qui passe un pointeur vers l’interface vers un autre pilote doit appeler InterfaceReference.

Notez que la routine InterfaceReference étant un contrat par interface, il n’existe aucune exigence IRQL générale pour l’appeler.