PINTERFACE_REFERENCE Rückruffunktion (wdm.h)

Artikel
08/08/2023

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.