PINTERFACE_DEREFERENCE Rückruffunktion (wdm.h)

Die InterfaceDereference-Routine dekrementiert die Verweisanzahl für eine vom Treiber definierte Schnittstelle.

Syntax

PINTERFACE_DEREFERENCE PinterfaceDereference;

void PinterfaceDereference(
  [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.

Beachten Sie, dass die InterfaceDereference-Routine ein Schnittstellenvertrag ist, sodass es keine allgemeinen IRQL-Anforderungen für den Aufruf gibt.

Rückgabewert

Keine

Bemerkungen

Sie können die InterfaceReference-Routine verwenden, um die Verweisanzahl für die Schnittstelle zu erhöhen.

Der Treiber, der die Schnittstelle importiert, ist für das Aufrufen der InterfaceDereference-Routine verantwortlich, um die Verweisanzahl zu erhöhen, nachdem der Treiber die Schnittstelle nicht mehr verwendet. Beispielsweise ruft ein Treiber, der einen Zeiger auf die Schnittstelle anfordert, indem er eine IRP_MN_QUERY_INTERFACE Anforderung sendet , InterfaceDereference auf. Außerdem muss ein Treiber, der einen Zeiger auf die Schnittstelle zu einem anderen Treiber empfängt, InterfaceDereference aufrufen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)

Weitere Informationen

SCHNITTSTELLE

IRP_MN_QUERY_INTERFACE

InterfaceReference