Función WdfInterruptCreate (wdfinterrupt.h)

[Se aplica a KMDF y UMDF]

El método WdfInterruptCreate crea un objeto de interrupción de marco.

Sintaxis

NTSTATUS WdfInterruptCreate(
  [in]           WDFDEVICE              Device,
  [in]           PWDF_INTERRUPT_CONFIG  Configuration,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFINTERRUPT           *Interrupt
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] Configuration

Puntero a una estructura de WDF_INTERRUPT_CONFIG inicializada por una llamada a WDF_INTERRUPT_CONFIG_INIT.

[in, optional] Attributes

Puntero a una estructura WDF_OBJECT_ATTRIBUTES que especifica atributos de objeto para el objeto de interrupción del marco. (Vea comentarios para obtener información adicional). Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES.

[out] Interrupt

Puntero a una ubicación que recibe un identificador para el nuevo objeto de interrupción.

Valor devuelto

WdfInterruptCreate devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver uno de los valores siguientes.

Para obtener una lista de otros valores devueltos que puede devolver el método WdfInterruptCreate , vea Errores de creación de objetos de marco.

Este método también podría devolver otros valores NTSTATUS.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Los controladores suelen llamar al método WdfInterruptCreate desde una función de devolución de llamada EvtDriverDeviceAdd . A partir de kmdf versión 1.11 y UMDF versión 2.0, los controladores pueden llamar a WdfInterruptCreate desde EvtDevicePrepareHardware. Si el controlador llama a WdfInterruptCreate desde EvtDriverDeviceAdd, los miembros InterruptRaw e InterruptTranslated de la estructura WDF_INTERRUPT_CONFIG deben ser NULL. Si el controlador llama a WdfInterruptCreate desde EvtDevicePrepareHardware, estos miembros deben ser válidos.

Si va a crear un objeto de interrupción compatible con reactivación, como se describe en Uso de una interrupción para reactivar un dispositivo, debe llamar a WdfInterruptCreate desde EvtDevicePrepareHardware.

El controlador debe llamar a WdfInterruptCreate una vez para cada vector de interrupción que requiera su dispositivo. Si el dispositivo admite interrupciones señaladas por mensajes (MSI), el controlador debe crear un objeto de interrupción para cada mensaje que el dispositivo pueda admitir.

Una vez que el administrador de PnP asigna recursos del sistema al dispositivo, el marco almacena información sobre los recursos de interrupción asignados del dispositivo en los objetos de interrupción creados por el controlador. (Los controladores que no admiten Plug and Play no pueden usar objetos de interrupción).

Es posible que el sistema no asigne todos los recursos de interrupción que un dispositivo pueda admitir. Por ejemplo, un controlador crearía ocho objetos de interrupción para un dispositivo capaz de admitir ocho mensajes MSI. Sin embargo, el sistema puede asignar solo un mensaje al dispositivo. En ese caso, siete de los objetos de interrupción no se usarán.

Normalmente, el controlador debe almacenar información específica de la interrupción, como el contenido copiado de los registros de interrupciones del dispositivo, en el espacio de contexto del objeto de interrupción. La estructura WDF_OBJECT_ATTRIBUTES que el controlador pasa a WdfInterruptCreate debe describir el espacio de contexto.

En el caso de los controladores que usan la versión 1.9 del marco y versiones anteriores, el elemento primario de cada objeto de interrupción es el objeto de dispositivo al que pertenece la interrupción. El controlador no puede cambiar este elemento primario y el miembro ParentObject de la estructura WDF_OBJECT_ATTRIBUTES debe ser NULL. A partir de la versión 1.11, ParentObject puede ser un objeto de dispositivo de marco o un objeto de cola. Si el controlador especifica un elemento primario, el controlador debe establecer el miembro AutomaticSerialization de la estructura de configuración en TRUE. El controlador puede especificar un elemento primario para ambas interrupciones en DIRQL y interrupciones de nivel pasivo.

Si el controlador proporciona funciones de devolución de llamada EvtCleanupCallback o EvtDestroyCallback para el objeto de interrupción del marco, tenga en cuenta que el marco llama a estas funciones de devolución de llamada en IRQL = PASSIVE_LEVEL.

Para obtener más información sobre el control de interrupciones en controladores basados en marcos, consulte Control de interrupciones de hardware.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_INTERRUPT_CONFIG y una estructura de WDF_OBJECT_ATTRIBUTES y, a continuación, se llama a WdfInterruptCreate.

NTSTATUS  status;
WDF_INTERRUPT_CONFIG  interruptConfig;
WDF_OBJECT_ATTRIBUTES  interruptAttributes;

WDF_INTERRUPT_CONFIG_INIT(
                          &interruptConfig,
                          MyEvtInterruptIsr,
                          MyEvtInterruptDpc
                          );
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
                                        &interruptAttributes,
                                        INTERRUPT_DATA
                                        );
status = WdfInterruptCreate(
                            device,
                            &interruptConfig,
                            &interruptAttributes,
                            &devExt->WdfInterrupt
                            );

Requisitos

Consulte también

EvtDriverDeviceAdd

WDF_INTERRUPT_CONFIG

WDF_INTERRUPT_CONFIG_INIT

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE