windows-nt/Source/XPSP1/NT/base/ntos/po/idle.c
2020-09-26 16:20:57 +08:00

320 lines
8.2 KiB
C

/*++
Copyright (c) 1990 Microsoft Corporation
Module Name:
idle.c
Abstract:
This module implements the power management idle timing code for
device objects
Author:
Bryan Willman (bryanwi) 7-Nov-96
Revision History:
--*/
#include "pop.h"
NTKERNELAPI
PULONG
PoRegisterDeviceForIdleDetection (
IN PDEVICE_OBJECT DeviceObject,
IN ULONG ConservationIdleTime,
IN ULONG PerformanceIdleTime,
IN DEVICE_POWER_STATE State
)
/*++
Routine Description:
A device driver calls this routine to either:
a. Create and initialize a new idle detection block
b. Reset values in an existing idle detection block
If the device object has an idle detection block, it is
filled in with new values.
Otherwise, an idle detect block is created and linked to the device
object.
Arguments:
DeviceObject - Device object which wants idle detection, set_power
IRPs will be sent here
ConservationIdleTime - timeout for system in "conserve mode"
PerformanceIdleTime - timeout for system in "performance mode"
Type - Type of set_power sent (for set_power irp)
State - what state to go to (for set_power irp)
Return Value:
NULL - if an attempt to create a new idle block failed
non-NULL - if an idle block was created, or if an existing one was reset
--*/
{
PDEVICE_OBJECT_POWER_EXTENSION pdope;
KIRQL OldIrql;
NTSTATUS Status;
ULONG DeviceType, OldDeviceType;
ASSERT(KeGetCurrentIrql() < DISPATCH_LEVEL);
//
// deal with the case where idle detection is being turned off
//
if ((ConservationIdleTime == 0) && (PerformanceIdleTime == 0)) {
PopLockDopeGlobal(&OldIrql);
pdope = DeviceObject->DeviceObjectExtension->Dope;
if (pdope == NULL) {
//
// cannot be linked into the chain, so must already be off,
// so we're done
//
} else {
//
// there is a pdope, so we may be on the idle list
//
if ((pdope->IdleList.Flink == &(pdope->IdleList)) &&
(pdope->IdleList.Blink == &(pdope->IdleList)))
{
//
// we're off the queue already, so we're done
//
} else {
//
// a dope vector exists and is on the idle scan list,
// so we must delist ourselves
//
RemoveEntryList(&(pdope->IdleList));
OldDeviceType = pdope->DeviceType | ES_CONTINUOUS;
pdope->DeviceType = 0;
PopApplyAttributeState (ES_CONTINUOUS, OldDeviceType);
pdope->ConservationIdleTime = 0L;
pdope->PerformanceIdleTime = 0L;
pdope->State = PowerDeviceUnspecified;
pdope->IdleCount = 0;
InitializeListHead(&(pdope->IdleList));
}
}
PopUnlockDopeGlobal(OldIrql);
return NULL;
}
//
// Set DeviceType if this is an idle registration by type
//
DeviceType = 0;
if (ConservationIdleTime == (ULONG) -1 &&
PerformanceIdleTime == (ULONG) -1) {
switch (DeviceObject->DeviceType) {
case FILE_DEVICE_DISK:
case FILE_DEVICE_MASS_STORAGE:
DeviceType = POP_DISK_SPINDOWN | ES_CONTINUOUS;
break;
default:
//
// Unsupported type
//
return NULL;
}
}
//
// now, the case where it's being turned on
//
pdope = PopGetDope(DeviceObject);
if (pdope == NULL) {
//
// we didn't have a DOPE structure and couldn't allocate one, fail
//
return (PVOID)NULL;
}
//
// May be a newly allocated Dope, or an existing one.
// In either case, update values.
// Enqueue if not already in queue
//
PopLockDopeGlobal(&OldIrql);
OldDeviceType = pdope->DeviceType | ES_CONTINUOUS;
pdope->ConservationIdleTime = ConservationIdleTime;
pdope->PerformanceIdleTime = PerformanceIdleTime;
pdope->State = State;
pdope->IdleCount = 0;
pdope->DeviceType = (UCHAR) DeviceType;
if ((pdope->IdleList.Flink == &(pdope->IdleList)) &&
(pdope->IdleList.Blink == &(pdope->IdleList)))
{
//
// we're off the queue, and must be enqueued
//
InsertTailList(&PopIdleDetectList, &(pdope->IdleList));
}
PopUnlockDopeGlobal(OldIrql);
PopApplyAttributeState(DeviceType, OldDeviceType);
PopCheckForWork(TRUE);
return &(pdope->IdleCount); // success
}
VOID
PopScanIdleList(
IN PKDPC Dpc,
IN PVOID DeferredContext,
IN PVOID SystemArgument1,
IN PVOID SystemArgument2
)
/*++
Routine Description:
Called by the PopIdleScanTimer at PopIdleScanTimeInseconds interval,
this routine runs the list of Idle Blocks, finding any that meet the
trip conditions, and sends commands to the appropriate device objects
to change state.
The timer that calls this DPC is setup in poinit.c.
Arguments:
Standard DPC arguments, all are ignored.
Return Value:
None.
--*/
{
KIRQL OldIrql;
PLIST_ENTRY link;
ULONG idlelimit;
PDEVICE_OBJECT_POWER_EXTENSION pblock;
POWER_STATE PowerState;
PULONG pIdleCount;
ULONG oldCount;
PopLockDopeGlobal(&OldIrql);
link = PopIdleDetectList.Flink;
while (link != &PopIdleDetectList) {
pblock = CONTAINING_RECORD(link, DEVICE_OBJECT_POWER_EXTENSION, IdleList);
pIdleCount = &(pblock->IdleCount);
oldCount = InterlockedIncrement(pIdleCount);
switch (pblock->DeviceType) {
case 0:
idlelimit = pblock->PerformanceIdleTime;
if (PopIdleDetectionMode == PO_IDLE_CONSERVATION) {
idlelimit = pblock->ConservationIdleTime;
}
break;
case POP_DISK_SPINDOWN:
idlelimit = PopPolicy->SpindownTimeout;
break;
default:
PopInternalAddToDumpFile( NULL, 0, pblock->DeviceObject, NULL, NULL, pblock );
KeBugCheckEx( INTERNAL_POWER_ERROR,
0x200,
POP_IDLE,
(ULONG_PTR)pblock->DeviceObject,
(ULONG_PTR)pblock );
}
if ((idlelimit > 0) && ((oldCount+1) == idlelimit)) {
PowerState.DeviceState = pblock->State;
PoRequestPowerIrp (
pblock->DeviceObject,
IRP_MN_SET_POWER,
PowerState,
NULL,
NULL,
NULL
);
}
link = link->Flink;
}
PopUnlockDopeGlobal(OldIrql);
return;
}
PDEVICE_OBJECT_POWER_EXTENSION
PopGetDope (
PDEVICE_OBJECT DeviceObject
)
{
PDEVOBJ_EXTENSION Doe;
PDEVICE_OBJECT_POWER_EXTENSION Dope;
KIRQL OldIrql;
Doe = (PDEVOBJ_EXTENSION) DeviceObject->DeviceObjectExtension;
if (!Doe->Dope) {
PopLockDopeGlobal(&OldIrql);
if (!Doe->Dope) {
Dope = (PDEVICE_OBJECT_POWER_EXTENSION)
ExAllocatePoolWithTag(
NonPagedPool,
sizeof(DEVICE_OBJECT_POWER_EXTENSION),
POP_DOPE_TAG
);
if (Dope) {
RtlZeroMemory (Dope, sizeof(DEVICE_OBJECT_POWER_EXTENSION));
Dope->DeviceObject = DeviceObject;
Dope->State = PowerDeviceUnspecified;
InitializeListHead(&(Dope->IdleList));
InitializeListHead(&(Dope->NotifySourceList));
InitializeListHead(&(Dope->NotifyTargetList));
// force the signature to 0 so buildpowerchannel gets called
Dope->PowerChannelSummary.Signature = (ULONG)0;
InitializeListHead(&(Dope->PowerChannelSummary.NotifyList));
Doe->Dope = Dope;
}
}
PopUnlockDopeGlobal(OldIrql);
}
return Doe->Dope;
}