Compartir a través de


PINTERFACE_REFERENCE función de devolución de llamada (wdm.h)

La rutina InterfaceReference incrementa el recuento de referencias en una interfaz definida por el controlador.

Sintaxis

PINTERFACE_REFERENCE PinterfaceReference;

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

Parámetros

[in] Context

Puntero a información de contexto específica de la interfaz. El autor de la llamada pasa el valor que se pasa como miembro Context de la estructura INTERFACE de la interfaz.

Valor devuelto

None

Observaciones

Tenga en cuenta que se trata de un contrato por interfaz, por lo que no hay requisitos generales de IRQL en torno a InterfaceReference/Dereference.

Puede usar la rutina InterfaceDereference para disminuir el recuento de referencias de la interfaz.

El controlador que exporta la interfaz es responsable de llamar a InterfaceReference para incrementar el recuento de referencias antes de que el controlador exporte la interfaz. Por ejemplo, el controlador que exportó inicialmente la interfaz en respuesta a una solicitud de IRP_MN_QUERY_INTERFACE llama a InterfaceReference. Además, un controlador que pasa un puntero a la interfaz a otro controlador debe llamar a InterfaceReference.

Tenga en cuenta que la rutina InterfaceReference es un contrato por interfaz, por lo que no hay requisitos generales de IRQL para llamarlo.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)

Consulte también

INTERFAZ

IRP_MN_QUERY_INTERFACE

InterfaceDereference