Expand Minimize

FltGetEcpListFromCallbackData routine

The FltGetEcpListFromCallbackData routine returns a pointer to an extra create parameter context structure (ECP) list that is associated with a given create operation callback-data object.

Syntax


NTSTATUS FltGetEcpListFromCallbackData(
  _In_   PFLT_FILTER Filter,
  _In_   PFLT_CALLBACK_DATA Data,
  _Out_  PECP_LIST *EcpList
);

Parameters

Filter [in]

An opaque filter pointer to the minifilter driver. This pointer uniquely identifies the minifilter driver and remains constant as long as the minifilter driver is loaded.

Data [in]

A pointer to a callback-data object of type FLT_CALLBACK_DATA, which represents the create operation.

EcpList [out]

Receives a pointer to the ECP list that is associated with the Data callback-data object.

Return value

FltGetEcpListFromCallbackData returns one of the following NTSTATUS values:

Return codeDescription
STATUS_SUCCESS

EcpList received a pointer to the ECP list that is associated with the given callback-data object. If the callback-data object has no associated ECP, STATUS_SUCCESS is returned and EcpList is NULL.

STATUS_INVALID_PARAMETER

The given callback-data object was not an IRP-based create operation. In this case, EcpList is undefined.

 

Remarks

To attach an ECP list to a callback-data object, use the FltSetEcpListIntoCallbackData routine.

Requirements

Version

This routine is available starting with Windows Vista.

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

<= APC_LEVEL

See also

ECP_LIST
FLT_CALLBACK_DATA
FltAcknowledgeEcp
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterList
FltCreateFileEx2
FltDeleteExtraCreateParameterLookasideList
FltFindExtraCreateParameter
FltFreeExtraCreateParameter
FltFreeExtraCreateParameterList
FltGetNextExtraCreateParameter
FltInitExtraCreateParameterLookasideList
FltInsertExtraCreateParameter
FltIsEcpAcknowledged
FltIsEcpFromUserMode
FltRemoveExtraCreateParameter
FltSetEcpListIntoCallbackData
IoCreateFileEx

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.