PINTERFACE_REFERENCE - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// miniport.h

PINTERFACE_REFERENCE PinterfaceReference;

VOID PinterfaceReference(
  [in] PVOID Context
)
{...}

View the official Windows Driver Kit DDI reference
// wdm.h

PINTERFACE_REFERENCE PinterfaceReference;

VOID PinterfaceReference(
  [in] PVOID Context
)
{...}

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-miniport-pinterface_reference)

PINTERFACE_REFERENCE callback function (miniport.h)

Description

The InterfaceReference routine increments the reference count on a driver-defined interface.

Parameters

Context [in]

A pointer to interface-specific context information. The caller passes the value that is passed as the Context member of the INTERFACE structure for the interface.

Remarks

You can use the InterfaceDereference routine to decrement the reference count for the interface.

The driver that exports the interface is responsible for calling InterfaceReference to increment the reference count before the driver exports the interface. For example, the driver that initially exported the interface in response to an IRP_MN_QUERY_INTERFACE request calls InterfaceReference. Also, a driver that passes a pointer to the interface to another driver must call InterfaceReference.

See also

INTERFACE

IRP_MN_QUERY_INTERFACE

InterfaceDereference


Windows Driver Kit DDI reference (nc-wdm-pinterface_reference)

PINTERFACE_REFERENCE callback function (wdm.h)

Description

The InterfaceReference routine increments the reference count on a driver-defined interface.

Parameters

Context [in]

A pointer to interface-specific context information. The caller passes the value that is passed as the Context member of the INTERFACE structure for the interface.

Remarks

Note that this is a per interface contract, so there are no general IRQL requirements around InterfaceReference/Dereference.

You can use the InterfaceDereference routine to decrement the reference count for the interface.

The driver that exports the interface is responsible for calling InterfaceReference to increment the reference count before the driver exports the interface. For example, the driver that initially exported the interface in response to an IRP_MN_QUERY_INTERFACE request calls InterfaceReference. Also, a driver that passes a pointer to the interface to another driver must call InterfaceReference.

Note that the InterfaceReference routine is a per interface contract, so there are no general IRQL requirements for calling it.

See also

INTERFACE

IRP_MN_QUERY_INTERFACE

InterfaceDereference