PINTERFACE_REFERENCE Rückruffunktion (wdm.h)
Die InterfaceReference-Routine inkrementiert die Verweisanzahl auf einer vom Treiber definierten Schnittstelle.
Syntax
PINTERFACE_REFERENCE PinterfaceReference;
void PinterfaceReference(
[in] PVOID Context
)
{...}
Parameter
[in] Context
Ein Zeiger auf schnittstellenspezifische Kontextinformationen. Der Aufrufer übergibt den Wert, der als Context-Member der INTERFACE-Struktur für die Schnittstelle übergeben wird.
Rückgabewert
Keine
Bemerkungen
Beachten Sie, dass dies ein Schnittstellenvertrag ist, sodass es keine allgemeinen IRQL-Anforderungen für InterfaceReference/Deeference gibt.
Sie können die InterfaceDereference-Routine verwenden, um die Verweisanzahl für die Schnittstelle zu dekrementieren.
Der Treiber, der die Schnittstelle exportiert, ist für den Aufruf von InterfaceReference verantwortlich, um die Verweisanzahl zu erhöhen, bevor der Treiber die Schnittstelle exportiert. Beispielsweise ruft der Treiber, der die Schnittstelle ursprünglich als Reaktion auf eine IRP_MN_QUERY_INTERFACE-Anforderung exportiert hat , InterfaceReference auf. Außerdem muss ein Treiber, der einen Zeiger auf die Schnittstelle an einen anderen Treiber übergibt , InterfaceReference aufrufen.
Beachten Sie, dass die InterfaceReference-Routine ein Schnittstellenvertrag ist, sodass es keine allgemeinen IRQL-Anforderungen für den Aufruf gibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h) |