PINTERFACE_REFERENCE función de devolución de llamada (wdm.h)
La InterfaceReference rutina 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 el miembro Context de la estructura INTERFACE de para la interfaz.
Valor devuelto
Ninguno
Observaciones
Tenga en cuenta que se trata de un contrato por interfaz, por lo que no hay ningún requisito general 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 | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h) |