FsRtlNotifyInitializeSync routine

The FsRtlNotifyInitializeSync routine allocates and initializes a synchronization object for a notify list.

Syntax


VOID FsRtlNotifyInitializeSync(
  _In_ PNOTIFY_SYNC *NotifySync
);

Parameters

NotifySync [in]

A pointer to a location in which to return a pointer to the opaque synchronization object.

Return value

None

Remarks

The system allocates the synchronization object from nonpaged pool. If a pool allocation failure occurs, FsRtlNotifyInitializeSync raises a STATUS_INSUFFICIENT_RESOURCES exception. To gain control if this pool allocation failure occurs, the driver should wrap the call to FsRtlNotifyInitializeSync in a try-except or try-finally statement.

Every successful call to FsRtlNotifyInitializeSync must be matched by a subsequent call to FsRtlNotifyUninitializeSync.

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

<= APC_LEVEL

See also

FsRtlNotifyUninitializeSync

 

 

Send comments about this topic to Microsoft

Show: