FsRtlPostPagingFileStackOverflow function (ntifs.h)

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

[in] Context

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

[in] Event

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.

[in] StackOverflowRoutine

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

Requirement	Value
Minimum supported client	Windows 2000
Target Platform	Universal
Header	ntifs.h (include FltKernel.h, Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

See also

FsRtlIsPagingFile

FsRtlPostStackOverflow

IoGetRemainingStackSize

KeInitializeEvent