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) |