filter.c File Reference

#include "FsRtlP.h"

Go to the source code of this file.

Defines
#define	Dbg   (0x80000000)
Functions
NTSTATUS	FsRtlNormalizeNtstatus (IN NTSTATUS Exception, IN NTSTATUS GenericException)
BOOLEAN	FsRtlIsNtstatusExpected (IN NTSTATUS Exception)
PVOID	FsRtlAllocatePool (IN POOL_TYPE PoolType, IN ULONG NumberOfBytes)
PVOID	FsRtlAllocatePoolWithQuota (IN POOL_TYPE PoolType, IN ULONG NumberOfBytes)
PVOID	FsRtlAllocatePoolWithTag (IN POOL_TYPE PoolType, IN ULONG NumberOfBytes, IN ULONG Tag)
PVOID	FsRtlAllocatePoolWithQuotaTag (IN POOL_TYPE PoolType, IN ULONG NumberOfBytes, IN ULONG Tag)
BOOLEAN	FsRtlIsTotalDeviceFailure (IN NTSTATUS Status)

---

Define Documentation

#define Dbg   (0x80000000)

Definition at line 45 of file fsrtl/filter.c.

---

Function Documentation

PVOID FsRtlAllocatePool (  IN POOL_TYPE  PoolType, IN ULONG  NumberOfBytes )

Definition at line 124 of file fsrtl/filter.c. References ExAllocatePoolWithTag, ExRaiseStatus(), and NULL. : This routine is used to allocate executive level pool. It either returns a non null pointer to the newly allocated pool or it raises a status of insufficient resources. Arguments: PoolType - Supplies the type of executive pool to allocate NumberOfBytes - Supplies the number of bytes to allocate Return Value: PVOID - Returns a non null pointer to the newly allocated pool. --*/ { PVOID p; // // Allocate executive pool and if we get back null then raise // a status of insufficient resources // if ((p = ExAllocatePoolWithTag( PoolType, NumberOfBytes, 'trSF')) == NULL) { ExRaiseStatus( STATUS_INSUFFICIENT_RESOURCES ); } return p; }

PVOID FsRtlAllocatePoolWithQuota (  IN POOL_TYPE  PoolType, IN ULONG  NumberOfBytes )

Definition at line 169 of file fsrtl/filter.c. References ExAllocatePoolWithQuotaTag, ExRaiseStatus(), and NULL. : This routine is used to allocate executive level pool with quota. It either returns a non null pointer to the newly allocated pool or it raises a status of insufficient resources. Arguments: PoolType - Supplies the type of executive pool to allocate NumberOfBytes - Supplies the number of bytes to allocate Return Value: PVOID - Returns a non null pointer to the newly allocated pool. --*/ { PVOID p; // // Allocate executive pool and if we get back null then raise // a status of insufficient resources // if ((p = ExAllocatePoolWithQuotaTag ( PoolType, NumberOfBytes, 'trSF')) == NULL) { ExRaiseStatus( STATUS_INSUFFICIENT_RESOURCES ); } return p; }

PVOID FsRtlAllocatePoolWithQuotaTag (  IN POOL_TYPE  PoolType, IN ULONG  NumberOfBytes, IN ULONG  Tag )

Definition at line 260 of file fsrtl/filter.c. References ExAllocatePoolWithQuotaTag, ExRaiseStatus(), and NULL. : This routine is used to allocate executive level pool with a quota tag. Arguments: PoolType - Supplies the type of executive pool to allocate NumberOfBytes - Supplies the number of bytes to allocate Tag - Supplies the tag for the pool block Return Value: PVOID - Returns a non null pointer to the newly allocated pool. --*/ { PVOID p; // // Allocate executive pool and if we get back null then raise // a status of insufficient resources // if ((p = ExAllocatePoolWithQuotaTag( PoolType, NumberOfBytes, Tag)) == NULL) { ExRaiseStatus( STATUS_INSUFFICIENT_RESOURCES ); } return p; }

PVOID FsRtlAllocatePoolWithTag (  IN POOL_TYPE  PoolType, IN ULONG  NumberOfBytes, IN ULONG  Tag )

Definition at line 214 of file fsrtl/filter.c. References ExAllocatePoolWithTag, ExRaiseStatus(), and NULL. : This routine is used to allocate executive level pool with a tag. Arguments: PoolType - Supplies the type of executive pool to allocate NumberOfBytes - Supplies the number of bytes to allocate Tag - Supplies the tag for the pool block Return Value: PVOID - Returns a non null pointer to the newly allocated pool. --*/ { PVOID p; // // Allocate executive pool and if we get back null then raise // a status of insufficient resources // if ((p = ExAllocatePoolWithTag( PoolType, NumberOfBytes, Tag)) == NULL) { ExRaiseStatus( STATUS_INSUFFICIENT_RESOURCES ); } return p; }

BOOLEAN FsRtlIsNtstatusExpected (  IN NTSTATUS  Exception  )

Definition at line 82 of file fsrtl/filter.c. References FALSE, and TRUE. Referenced by CcExceptionFilter(), FsRtlCancelNotify(), FsRtlCopyRead(), FsRtlCopyWrite(), FsRtlMdlReadDev(), FsRtlNormalizeNtstatus(), FsRtlNotifyFullReportChange(), FsRtlPrepareMdlWriteDev(), LfsExceptionFilter(), UdfCreateUserMdl(), UdfExceptionFilter(), and UdfQueryDirectory(). : This routine is used to decide if a status is within the set of values handled by the exception filter. Arguments: Exception - Supplies the exception being queried Return Value: BOOLEAN - Returns TRUE if the value is handled by the filter, and FALSE otherwise. --*/ { switch (Exception) { case STATUS_DATATYPE_MISALIGNMENT: case STATUS_ACCESS_VIOLATION: case STATUS_ILLEGAL_INSTRUCTION: case STATUS_INSTRUCTION_MISALIGNMENT: return FALSE; default: return TRUE; } }

BOOLEAN FsRtlIsTotalDeviceFailure (  IN NTSTATUS  Status  )

Definition at line 304 of file fsrtl/filter.c. References FALSE, NT_SUCCESS, Status, and TRUE. Referenced by IopMountVolume(). 00310 : 00311 00312 This routine is given an NTSTATUS value and make a determination as to 00313 if this value indicates that the complete device has failed and therefore 00314 should no longer be used, or if the failure is one that indicates that 00315 continued use of the device is ok (i.e. a sector failure). 00316 00317 Arguments: 00318 00319 Status - the NTSTATUS value to test. 00320 00321 Return Value: 00322 00323 TRUE - The status value given is believed to be a fatal device error. 00324 FALSE - The status value given is believed to be a sector failure, but not 00325 a complete device failure. 00326 --*/ 00327 00328 { 00329 if (NT_SUCCESS(Status)) { 00330 00331 // 00332 // All warning and informational errors will be resolved here. 00333 // 00334 00335 return FALSE; 00336 } 00337 00338 switch (Status) { 00339 case STATUS_CRC_ERROR: 00340 case STATUS_DEVICE_DATA_ERROR: 00341 return FALSE; 00342 default: 00343 return TRUE; 00344 } 00345 } }

NTSTATUS FsRtlNormalizeNtstatus (  IN NTSTATUS  Exception, IN NTSTATUS  GenericException )

Definition at line 49 of file fsrtl/filter.c. References FsRtlIsNtstatusExpected(). Referenced by CcCopyRead(), CcCopyWrite(), CcFastCopyRead(), CcFastCopyWrite(), CcGetVacbMiss(), CcInitializeCacheMap(), CcMapAndCopy(), CcMdlWriteComplete2(), CcSetFileSizes(), UdfCommonRead(), and UdfNormalizeAndRaiseStatus(). : This routine is used to normalize an NTSTATUS into a status that is handled by the file system's top level exception handlers. Arguments: Exception - Supplies the exception being normalized GenericException - Supplies a second exception to translate to if the first exception is not within the set of exceptions handled by the filter Return Value: NTSTATUS - Returns Exception if the value is already handled by the filter, and GenericException otherwise. --*/ { return (FsRtlIsNtstatusExpected(Exception) ? Exception : GenericException); }

---