Export (0) Print
Expand All

InterfaceReference routine

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

Syntax


PINTERFACE_REFERENCE InterfaceReference;

VOID InterfaceReference(
  _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 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.

Requirements

Target platform

Desktop

Header

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

See also

INTERFACE
InterfaceDereference
IRP_MN_QUERY_INTERFACE

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft