InterfaceDereference routine

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

Syntax


PINTERFACE_DEREFERENCE InterfaceDereference;

VOID InterfaceDereference(
  _In_ PVOID Context
)
{ ... }

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.

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

Target platform

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

See also

INTERFACE
InterfaceReference
IRP_MN_QUERY_INTERFACE

 

 

Send comments about this topic to Microsoft

Show: