FsRtlPostPagingFileStackOverflow routine

The FsRtlPostPagingFileStackOverflow routine posts a paging file stack overflow item to the stack overflow thread.

Syntax


VOID FsRtlPostPagingFileStackOverflow(
  _In_ PVOID                         Context,
  _In_ PKEVENT                       Event,
  _In_ PFSRTL_STACK_OVERFLOW_ROUTINE StackOverflowRoutine
);

Parameters

Context [in]

A context pointer to pass to the stack overflow callback routine.

Event [in]

A pointer to a caller-allocated notification event to pass to the stack overflow callback routine. Must have been initialized as nonsignaled by calling KeInitializeEvent.

StackOverflowRoutine [in]

A pointer to a callback routine to be invoked when processing the request in the overflow thread.

Return value

None

Remarks

A file system typically calls FsRtlPostPagingFileStackOverflow during a paging file I/O operation when the amount of remaining stack space returned by IoGetRemainingStackSize is below the file system's stack overflow read threshold. FsRtlPostPagingFileStackOverflow posts the paging I/O request to a special paging stack overflow work queue. When the paging I/O operation has been completed, the caller's Event is set to a signaled state.

Note  Warning: File system filter drivers must never call FsRtlPostPagingFileStackOverflow, because doing so can halt the forward progress of paging file I/O operations.
 

Requirements

Target platform

Universal

Version

This routine is available on Microsoft Windows 2000 and later versions of Windows operating systems.

Header

Ntifs.h (include FltKernel.h or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<= DISPATCH_LEVEL

See also

FsRtlIsPagingFile
FsRtlPostStackOverflow
IoGetRemainingStackSize
KeInitializeEvent

 

 

Send comments about this topic to Microsoft

Show: