WdfInterruptReportActive-Funktion (wdfinterrupt.h)
[Gilt nur für KMDF]
WdfInterruptReportActive informiert das System darüber, dass der Interrupt aktiv ist und der Treiber bereit ist, Interruptanforderungen für die zugeordneten Zeilen zu verarbeiten.
Syntax
void WdfInterruptReportActive(
[in] WDFINTERRUPT Interrupt
);
Parameter
[in] Interrupt
Ein Handle für ein Framework-Interruptobjekt.
Rückgabewert
Keine
Bemerkungen
Nur Treiber, die die Energieverwaltung für den funktionalen Zustand implementieren, rufen WdfInterruptReportActive auf.
Ein Treiber muss WdfInterruptReportActive nicht sofort nach dem Erstellen eines Interrupts aufrufen. Der Treiber sollte WdfInterruptReportActive nur aufrufen, nachdem er zuvor WdfInterruptReportInactive aufgerufen hat.
In der Regel ruft ein Treiber WdfInterruptReportActive entweder aus seiner ComponentActiveConditionCallback-Routine oder aus ComponentIdleStateCallback auf, wenn State 0 ist (was den vollständigen F0-Zustand angibt).
Wenn Ihr Treiber diese Methode auf einem früheren Betriebssystem als Windows 8 aufruft, meldet die Überprüfung des Frameworks einen Fehler.
Weitere Informationen finden Sie unter Unterstützen funktionaler Energiezustände.
Beispiele
Das folgende Beispiel zeigt, wie ein Treiber WdfInterruptReportActive aus der 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;
PINTERRUPT_CONTEXT interruptContext;
deviceData = FdoGetData((WDFDEVICE)Context);
interruptContext = InterruptGetData(deviceData->Interrupt);
switch (State) {
case 0:
if (interruptContext->ReportedInactive) {
//
// the interrupt was reported inactive earlier. We need to report active now.
//
WdfInterruptReportActive(deviceData->Interrupt);
interruptContext->ReportedInactive = FALSE;
//
// Enable interrupt generation at hardware.
//
WdfInterruptAcquireLock(deviceData->Interrupt);
EnableInterruptInHardware();
WdfInterruptReleaseLock(deviceData->Interrupt);
}
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 Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf) |