PINTERFACE_REFERENCE fonction de rappel (wdm.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h) |