WdfInterruptReportInactive-Funktion (wdfinterrupt.h)

[Gilt nur für KMDF]

Die WdfInterruptReportInactive-Methode informiert das System darüber, dass der Interrupt nicht mehr aktiv ist und der Treiber keine Interruptanforderungen für die zugeordneten Zeilen erwartet.

Syntax

void WdfInterruptReportInactive(
  [in] WDFINTERRUPT Interrupt
);

Parameter

[in] Interrupt

Ein Handle für ein Framework-Interruptobjekt.

Rückgabewert

Keine

Bemerkungen

Nur Treiber, die die Energieverwaltung für funktionalen Zustand implementieren, rufen WdfInterruptReportInactive auf.

Wenn ein Treiber WdfInterruptReportInactive aufruft, kann das Energieverwaltungsframework (PoFx) verwandte Energieverwaltungsaufgaben ausführen.

In der Regel ruft ein Treiber WdfInterruptReportInactive entweder über seine ComponentIdleConditionCallback-Routine oder über ComponentIdleStateCallback auf, wenn State größer als 0 ist (was einen Fx-Zustand mit niedriger Leistung angibt).

Wenn Ihr Treiber diese Methode unter einem Betriebssystem vor Windows 8 aufruft, meldet die Überprüfung des Frameworks einen Fehler.

Beispiele

Das folgende Beispiel zeigt, wie ein Treiber WdfInterruptReportInactive über die ComponentIdleStateCallback-Routine eines KMDF-Treibers aufrufen kann. Der Treiber registriert eine einzelne Komponente, indem er WdfDeviceWdmAssignPowerFrameworkSettings aufruft.

VOID
MyComponentIdleStateCallback(
    _In_ PVOID Context,
    _In_ ULONG Component,
    _In_ ULONG State
    )
{
    PFDO_DEVICE_DATA deviceData;
    PFDO_INTERRUPT_CONTEXT interruptContext;

    deviceData = FdoGetData((WDFDEVICE)Context);
    interruptContext = InterruptGetData(deviceData->Interrupt);

    switch (State) {
        case 0:
             …
            break;

        //
        // PoFx may make us go to any of the F-states directly, hence we execute
        // F0Exit code for all of the Fx states. Note that transition to any Fx 
        // state happens from F0 (and not another Fx state).
        //
        default:
            //
            // Disable interrupt generation at hardware if needed.
            // 
            WdfInterruptAcquireLock(deviceData->Interrupt);
            DisableInterruptInHardware();
            WdfInterruptReleaseLock(deviceData->Interrupt);

            //
            // Report that interrupt is now inactive.
            //
            WdfInterruptReportInactive(deviceData->Interrupt);

            interruptContext->ReportedInactive = TRUE;

        break;

    …

}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Zielplattform	Universell
KMDF-Mindestversion	1.11
Kopfzeile	wdfinterrupt.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf)

Weitere Informationen

WdfInterruptReportActive