Estructura INTERFACE (wdm.h)
La estructura INTERFACE describe una interfaz exportada por un controlador para que la usen otros controladores.
Sintaxis
typedef struct _INTERFACE {
USHORT Size;
USHORT Version;
PVOID Context;
PINTERFACE_REFERENCE InterfaceReference;
PINTERFACE_DEREFERENCE InterfaceDereference;
} INTERFACE, *PINTERFACE;
Miembros
Size
Tamaño, en bytes, de una estructura que define una interfaz de controlador, incluida esta estructura y miembros específicos de la interfaz.
Version
Versión de la interfaz definida por el controlador.
Context
Puntero a información de contexto específica de la interfaz.
InterfaceReference
Puntero a una rutina InterfaceReference proporcionada por el controlador que incrementa el recuento de referencias de la interfaz.
InterfaceDereference
Puntero a una rutina InterfaceDereference proporcionada por el controlador que disminuye el recuento de referencias de la interfaz.
Comentarios
La estructura INTERFACE debe incluirse como primer miembro de todas las estructuras que describen las interfaces devueltas por los controladores en respuesta a una solicitud de IRP_MN_QUERY_INTERFACE .
El controlador que exporta la interfaz debe llamar a la rutina InterfaceReference cada vez que el controlador proporciona esa interfaz en respuesta a IRP_MN_QUERY_INTERFACE. Del mismo modo, si el controlador que solicita la interfaz lo pasa posteriormente a otro controlador, el controlador que pasa la interfaz debe llamar a InterfaceReference en nombre del controlador que lo recibe.
Cada controlador que importe la interfaz (ya sea enviando IRP_MN_QUERY_INTERFACE o recibiendo la interfaz de otro controlador) debe llamar a la rutina InterfaceDereference después de que haya terminado de usar la interfaz . Después de llamar a la rutina InterfaceDereference , un controlador no puede volver a usar la interfaz sin volver a detenerla primero.
Al introducir una nueva versión de una interfaz existente, cree un NUEVO GUID en lugar de revisar los campos Tamaño o Versión de esta estructura. Para obtener más información, consulta Uso de interfaces de Driver-Defined.
Requisitos
| Requisito | Valor |
|---|---|
| Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h) |