PINTERFACE_REFERENCE Rückruffunktion (wdm.h)

Die InterfaceReference Routine erhöht die Referenzanzahl auf einer treiberdefinierten 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

Nichts

Bemerkungen

Beachten Sie, dass dies ein Vertrag pro Schnittstelle ist, sodass es keine allgemeinen IRQL-Anforderungen rund um InterfaceReference/Dereference gibt.

Sie können die InterfaceDereference Routine verwenden, um die Referenzanzahl für die Schnittstelle zu erhöhen.

Der Treiber, der die Schnittstelle exportiert, ist für das Aufrufen InterfaceReference- verantwortlich, um die Referenzanzahl zu erhöhen, bevor der Treiber die Schnittstelle exportiert. Der Treiber, der die Schnittstelle zunächst als Reaktion auf eine IRP_MN_QUERY_INTERFACE Anforderung exportiert hat, ruft z. B. InterfaceReferenceauf. Außerdem muss ein Treiber, der einen Zeiger an die Schnittstelle an einen anderen Treiber übergibt, InterfaceReference-aufrufen.

Beachten Sie, dass die InterfaceReference Routine ein Schnittstellenvertrag ist, sodass keine allgemeinen IRQL-Anforderungen zum Aufrufen vorhanden sind.

Anforderungen

Siehe auch

INTERFACE-

IRP_MN_QUERY_INTERFACE

InterfaceDereference-