PINTERFACE_DEREFERENCE callback function (miniport.h)

  • Article

The InterfaceDereference routine decrements the reference count on a driver-defined interface.

Syntax

PINTERFACE_DEREFERENCE PinterfaceDereference;

void PinterfaceDereference(
  [in] PVOID Context
)
{...}

Parameters

[in] Context

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.

Return value

None

Remarks

You can use the InterfaceReference routine to increment the reference count for the interface.

The driver that imports the interface is responsible for calling the InterfaceDereference routine to decrement the reference count after the driver is no longer using the interface. For example, a driver that requests a pointer to the interface by sending an IRP_MN_QUERY_INTERFACE request calls InterfaceDereference. Also, a driver that receives a pointer to the interface to another driver must call InterfaceDereference.

Requirements

Requirement Value
Target Platform Desktop
Header miniport.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)

See also

INTERFACE

IRP_MN_QUERY_INTERFACE

InterfaceReference