Edit

FsRtlInitializeExtraCreateParameter function (ntifs.h)

  • Article

The FsRtlInitializeExtraCreateParameter routine initializes an extra create parameter (ECP) context structure.

Syntax

void FsRtlInitializeExtraCreateParameter(
  [in]           PECP_HEADER                                    Ecp,
  [in]           ULONG                                          EcpFlags,
  [in, optional] PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK CleanupCallback,
  [in]           ULONG                                          TotalSize,
  [in]           LPCGUID                                        EcpType,
  [in, optional] PVOID                                          ListAllocatedFrom
);

Parameters

[in] Ecp

Pointer to the ECP context structure to initialize.

[in] EcpFlags

Defines initialization options. Currently, no flags are defined.

[in, optional] CleanupCallback

Optional pointer to a filter-defined cleanup callback routine of type PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK. The cleanup callback routine is called when the ECP context structure (created by the FsRtlAllocateExtraCreateParameter routine) is deleted. Set this parameter to NULL if a cleanup callback routine is not applicable.

[in] TotalSize

The size, in bytes, of the ECP context structure to initialize.

[in] EcpType

Pointer to a GUID that indicates the type of ECP for which the context structure will be initialized. For more information about ECPs, see Using Extra Create Parameters with an IRP_MJ_CREATE Operation.

[in, optional] ListAllocatedFrom

Optional pointer to the list from which the ECP context structure is allocated.

Return value

None

Requirements

Requirement Value
Minimum supported client The FsRtlInitializeExtraCreateParameter routine is available starting with Windows 7.
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

See also

FsRtlAllocateExtraCreateParameter

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK