193 lines
4 KiB
C
193 lines
4 KiB
C
/*++
|
||
|
||
Copyright (c) 1989 Microsoft Corporation
|
||
|
||
Module Name:
|
||
|
||
backpack.h
|
||
|
||
Abstract:
|
||
|
||
This module contains the package for pseudo polling. When a caller
|
||
requests the same operation and gets the same error return the rdr
|
||
must prevent flooding the network by backing off requests. Examples
|
||
of when this is desirable are receiving 0 bytes on consequtive reads
|
||
and consequtive fails on a file lock.
|
||
|
||
If the caller is flooding the network, the rdr will return the 0 bytes
|
||
or lock fail to the user until NextTime. When NextTime is reached
|
||
the network will be used.
|
||
|
||
Author:
|
||
|
||
Colin Watson (colinw) 02-Jan-1991
|
||
|
||
|
||
Revision History:
|
||
|
||
ColinWatson [ColinW] 02-Jan-1991 Created
|
||
Joe Linn [JoeLinn] 10-Oct-1996 Lifted from rdr1 and massaged for rdr2
|
||
|
||
|
||
--*/
|
||
|
||
#ifndef _BACKPACK_
|
||
#define _BACKPACK_
|
||
|
||
typedef struct _THROTTLING_STATE {
|
||
LARGE_INTEGER NextTime; // Do not access the network until
|
||
// CurrentTime >= NextTime
|
||
ULONG CurrentIncrement; // Number of Increments applied to calculate NextTime
|
||
ULONG MaximumDelay; // Specifies slowest rate that we will back off to
|
||
// NextTime <= CurrentTime + (Interval * MaximumDelay)
|
||
LARGE_INTEGER Increment;// {0,10000000} == 1 second
|
||
ULONG NumberOfQueries;
|
||
} THROTTLING_STATE, *PTHROTTLING_STATE;
|
||
|
||
//++
|
||
//
|
||
// VOID
|
||
// RxInitializeThrottlingState(
|
||
// IN PTHROTTLING_STATE pBP,
|
||
// IN ULONG Increment,
|
||
// IN ULONG MaximumDelay
|
||
// );
|
||
//
|
||
// Routine Description:
|
||
//
|
||
// This routine is called to initialize the back off structure (usually in
|
||
// an Icb).
|
||
//
|
||
// Arguments:
|
||
//
|
||
// pBP - Supplies back pack data for this request.
|
||
// Increment - Supplies the increase in delay in milliseconds, each time a request
|
||
// to the network fails.
|
||
// MaximumDelay- Supplies the longest delay the backoff package can introduce
|
||
// in milliseconds.
|
||
//
|
||
// Return Value:
|
||
//
|
||
// None.
|
||
//
|
||
//--
|
||
|
||
#define RxInitializeThrottlingState( _pBP, _Increment, _MaximumDelay ) { \
|
||
if ((_Increment)>0) { \
|
||
(_pBP)->Increment.QuadPart = (_Increment) * 10000; \
|
||
(_pBP)->MaximumDelay = (_MaximumDelay) / (_Increment); \
|
||
(_pBP)->CurrentIncrement = 0; \
|
||
}}
|
||
|
||
//++
|
||
//
|
||
// VOID
|
||
// RxUninitializeBackPack(
|
||
// IN PTHROTTLING_STATE pBP
|
||
// )
|
||
//
|
||
// Routine Description:
|
||
//
|
||
// Resets the Back Pack specified. Currently no work needed.
|
||
//
|
||
// Arguments:
|
||
//
|
||
// pBP - Supplies back pack address.
|
||
//
|
||
// Return Value:
|
||
//
|
||
// None.
|
||
//
|
||
//--
|
||
|
||
#define RxUninitializeBackPack( pBP ) ()
|
||
|
||
// RxShouldRequestBeThrottled indicates when the request should not go to the network.
|
||
|
||
BOOLEAN
|
||
RxShouldRequestBeThrottled(
|
||
IN PTHROTTLING_STATE pBP
|
||
);
|
||
|
||
// Register the last request as failed.
|
||
|
||
VOID
|
||
RxInitiateOrContinueThrottling (
|
||
IN PTHROTTLING_STATE pBP
|
||
);
|
||
|
||
// Register the last request as worked.
|
||
|
||
//++
|
||
//
|
||
// VOID
|
||
// RxTerminateThrottling(
|
||
// IN PTHROTTLING_STATE pBP
|
||
// )
|
||
//
|
||
// Routine Description:
|
||
//
|
||
// Sets the Delay to zero. This routine is called each time that
|
||
// a network request succeeds to avoid the next request backing off.
|
||
//
|
||
// Arguments:
|
||
//
|
||
// pBP - Supplies back pack address.
|
||
//
|
||
// Return Value:
|
||
//
|
||
// None.
|
||
//
|
||
//--
|
||
|
||
#define RxTerminateThrottling( pBP ) ( (pBP)->CurrentIncrement = 0 )
|
||
|
||
//++
|
||
//
|
||
// VOID
|
||
// RxInitializeBackoffPackage (
|
||
// VOID
|
||
// )
|
||
//
|
||
// Routine Description:
|
||
//
|
||
// This routine initializes the redirector back off package.
|
||
//
|
||
// Arguments:
|
||
//
|
||
// None
|
||
//
|
||
// Return Value:
|
||
//
|
||
// None.
|
||
//
|
||
//--
|
||
|
||
#define RxInitializeBackoffPackage( )
|
||
|
||
//++
|
||
//
|
||
// VOID
|
||
// RxUninitializeBackoffPackage (
|
||
// VOID
|
||
// )
|
||
//
|
||
// Routine Description:
|
||
//
|
||
// This routine uninitializes the redirector back off package.
|
||
//
|
||
// Arguments:
|
||
//
|
||
// None
|
||
//
|
||
// Return Value:
|
||
//
|
||
// None.
|
||
//
|
||
//--
|
||
|
||
#define RxUninitializeBackoffPackage( )
|
||
|
||
#endif /* _BACKPACK_ */
|
||
|
||
|