Fix heading jump, make parameters as list (#16685)

* Fixes

* Feedback

* Update functiontailcall2-function.md

* Update icorprofilercallback-jitcompilationfinished-method.md

* Update icorprofilerinfo8-getdynamicfunctioninfo-method.md

* Update icorprofilerinfo8-getfunctionfromip3-method.md

* Update icorprofilercallback-initialize-method.md

* Update icorprofilerinfo8-getdynamicfunctioninfo-method.md

Author: Youssef1313

docs/framework/unmanaged-api/profiling/functionenter-function.md

@@ -29,10 +29,12 @@ void __stdcall FunctionEnter (
 );  
 ```  
 
-## Parameters  
- `funcID`  
- [in] The identifier of the function to which control is passed.  
-  
+## Parameters
+
+- `funcID`
+
+  \[in] The identifier of the function to which control is passed.
+
 ## Remarks  
  The `FunctionEnter` function is a callback; you must implement it. The implementation must use the `__declspec`(`naked`) storage-class attribute.  
 

docs/framework/unmanaged-api/profiling/functionenter2-function.md

@@ -29,23 +29,28 @@ void __stdcall FunctionEnter2 (
 );  
 ```  
 
-## Parameters  
- `funcId`  
- [in] The identifier of the function to which control is passed.  
-  
- `clientData`  
- [in] The remapped function identifier, which the profiler previously specified by using the [FunctionIDMapper](../../../../docs/framework/unmanaged-api/profiling/functionidmapper-function.md) function.  
-  
- `func`  
- [in] A `COR_PRF_FRAME_INFO` value that points to information about the stack frame.  
-  
- The profiler should treat this as an opaque handle that can be passed back to the execution engine in the [ICorProfilerInfo2::GetFunctionInfo2](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo2-getfunctioninfo2-method.md) method.  
+## Parameters
+
+- `funcId`
+
+  \[in] The identifier of the function to which control is passed.
+
+- `clientData`
+
+  \[in] The remapped function identifier, which the profiler previously specified by using the [FunctionIDMapper](../../../../docs/framework/unmanaged-api/profiling/functionidmapper-function.md) function.
 
- `argumentInfo`  
- [in] A pointer to a [COR_PRF_FUNCTION_ARGUMENT_INFO](../../../../docs/framework/unmanaged-api/profiling/cor-prf-function-argument-info-structure.md) structure that specifies the locations in memory of the function's arguments.  
+- `func`
+
+  \[in] A `COR_PRF_FRAME_INFO` value that points to information about the stack frame.
 
- In order to access argument information, the `COR_PRF_ENABLE_FUNCTION_ARGS` flag must be set. The profiler can use the [ICorProfilerInfo::SetEventMask](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo-seteventmask-method.md) method to set the event flags.  
+  The profiler should treat this as an opaque handle that can be passed back to the execution engine in the [ICorProfilerInfo2::GetFunctionInfo2](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo2-getfunctioninfo2-method.md) method.  
 
+- `argumentInfo`
+
+  \[in] A pointer to a [COR_PRF_FUNCTION_ARGUMENT_INFO](../../../../docs/framework/unmanaged-api/profiling/cor-prf-function-argument-info-structure.md) structure that specifies the locations in memory of the function's arguments.
+
+  In order to access argument information, the `COR_PRF_ENABLE_FUNCTION_ARGS` flag must be set. The profiler can use the [ICorProfilerInfo::SetEventMask](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo-seteventmask-method.md) method to set the event flags.
+
 ## Remarks  
  The values of the `func` and `argumentInfo` parameters are not valid after the `FunctionEnter2` function returns because the values may change or be destroyed.  
 

docs/framework/unmanaged-api/profiling/functionenter3-function.md

@@ -24,10 +24,12 @@ Notifies the profiler that control is being passed to a function.
 void __stdcall FunctionEnter3(FunctionOrRemappedID functionOrRemappedID);  
 ```  
   
-## Parameters  
- `functionOrRemappedID`  
- [in] The identifier of the function to which control is passed.  
-  
+## Parameters
+
+- `functionOrRemappedID`
+
+  \[in] The identifier of the function to which control is passed.
+
 ## Remarks  
  The `FunctionEnter3` callback function notifies the profiler as functions are being called, but does not support argument inspection. Use the [ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo3-setenterleavefunctionhooks3-method.md) to register your implementation of this function.  
   

docs/framework/unmanaged-api/profiling/functionenter3withinfo-function.md

@@ -26,13 +26,16 @@ void __stdcall FunctionEnter3WithInfo(
                [in] COR_PRF_ELT_INFO eltInfo);  
 ```  
   
-## Parameters  
- `functionIDOrClientID`  
- [in] The identifier of the function to which control is passed.  
-  
- `eltInfo`  
- [in] An opaque handle that represents information about a given stack frame. This handle is valid only during the callback to which it is passed.  
-  
+## Parameters
+
+- `functionIDOrClientID`
+
+  \[in] The identifier of the function to which control is passed.
+
+- `eltInfo`
+
+  \[in] An opaque handle that represents information about a given stack frame. This handle is valid only during the callback to which it is passed.
+
 ## Remarks  
  The `FunctionEnter3WithInfo` callback method notifies the profiler as functions are called, and enables the profiler to use the [ICorProfilerInfo3::GetFunctionEnter3Info method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo3-getfunctionenter3info-method.md) to inspect argument values. To access argument information, the `COR_PRF_ENABLE_FUNCTION_ARGS` flag has to be set. The profiler can use the [ICorProfilerInfo::SetEventMask method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo-seteventmask-method.md) to set the event flags, and then use the [ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo3-setenterleavefunctionhooks3withinfo-method.md) to register your implementation of this function.  
   

docs/framework/unmanaged-api/profiling/functionidmapper-function.md

@@ -27,13 +27,16 @@ UINT_PTR __stdcall FunctionIDMapper (
 );  
 ```  
 
-## Parameters  
- `funcId`  
- [in] The function identifier to be remapped.  
-  
- `pbHookFunction`  
- [out] A pointer to a value that the profiler sets to `true` if it wants to receive `FunctionEnter2`, `FunctionLeave2`, and `FunctionTailcall2` callbacks; otherwise, it sets this value to `false`.  
-  
+## Parameters
+
+- `funcId`
+
+  \[in] The function identifier to be remapped.
+
+- `pbHookFunction`
+
+  \[out] A pointer to a value that the profiler sets to `true` if it wants to receive `FunctionEnter2`, `FunctionLeave2`, and `FunctionTailcall2` callbacks; otherwise, it sets this value to `false`.
+
 ## Return Value  
  The profiler returns a value that the execution engine uses as an alternative function identifier. The return value cannot be null unless `false` is returned in `pbHookFunction`. Otherwise, a null return value will produce unpredictable results, including possibly halting the process.  
 

docs/framework/unmanaged-api/profiling/functionidmapper2-function.md

@@ -28,16 +28,20 @@ UINT_PTR __stdcall FunctionIDMapper2 (
 );  
 ```  
 
-## Parameters  
- `funcId`  
- [in] The function identifier to be remapped.  
-  
- `clientData`  
- [in] A pointer to data that is used to disambiguate among runtimes.  
-  
- `pbHookFunction`  
- [out] A pointer to a value that the profiler sets to `true` if it wants to receive `FunctionEnter3`, `FunctionLeave3`, and `FunctionTailcall3`, or `FunctionEnter3WithInfo`, `FunctionLeave3WithInfo`, and `FunctionTailcall3WithInfo` callbacks; otherwise, it sets this value to `false`.  
-  
+## Parameters
+
+- `funcId`
+
+  \[in] The function identifier to be remapped.
+
+- `clientData`
+
+  \[in] A pointer to data that is used to disambiguate among runtimes.
+
+- `pbHookFunction`
+
+  \[out] A pointer to a value that the profiler sets to `true` if it wants to receive `FunctionEnter3`, `FunctionLeave3`, and `FunctionTailcall3`, or `FunctionEnter3WithInfo`, `FunctionLeave3WithInfo`, and `FunctionTailcall3WithInfo` callbacks; otherwise, it sets this value to `false`.
+
 ## Return Value  
  The profiler returns a value that the execution engine uses as an alternative function identifier. The return value cannot be null unless `false` is returned in `pbHookFunction`. Otherwise, a null return value produces unpredictable results, including possibly halting the process.  
 

docs/framework/unmanaged-api/profiling/functionleave-function.md

@@ -29,10 +29,12 @@ void __stdcall FunctionLeave (
 );  
 ```  
 
-## Parameters  
- `funcID`  
- [in] The identifier of the function that is returning.  
-  
+## Parameters
+
+- `funcID`
+
+  \[in] The identifier of the function that is returning.
+
 ## Remarks  
  The `FunctionLeave` function is a callback; you must implement it. The implementation must use the `__declspec`(`naked`) storage-class attribute.  
 

docs/framework/unmanaged-api/profiling/functionleave2-function.md

@@ -29,23 +29,28 @@ void __stdcall FunctionLeave2 (
 );  
 ```  
 
-## Parameters  
- `funcId`  
- [in] The identifier of the function that is returning.  
-  
- `clientData`  
- [in] The remapped function identifier, which the profiler previously specified via the [FunctionIDMapper](../../../../docs/framework/unmanaged-api/profiling/functionidmapper-function.md) function.  
-  
- `func`  
- [in] A `COR_PRF_FRAME_INFO` value that points to information about the stack frame.  
-  
- The profiler should treat this as an opaque handle that can be passed back to the execution engine in the [ICorProfilerInfo2::GetFunctionInfo2](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo2-getfunctioninfo2-method.md) method.  
-  
- `retvalRange`  
- [in] A pointer to a [COR_PRF_FUNCTION_ARGUMENT_RANGE](../../../../docs/framework/unmanaged-api/profiling/cor-prf-function-argument-range-structure.md) structure that specifies the memory location of the function's return value.  
-  
- In order to access return value information, the `COR_PRF_ENABLE_FUNCTION_RETVAL` flag must be set. The profiler can use the [ICorProfilerInfo::SetEventMask](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo-seteventmask-method.md) method to set the event flags.  
+## Parameters
+
+- `funcId`
+
+  \[in] The identifier of the function that is returning.
+
+- `clientData`
+
+  \[in] The remapped function identifier, which the profiler previously specified via the [FunctionIDMapper](../../../../docs/framework/unmanaged-api/profiling/functionidmapper-function.md) function.
+
+- `func`
+
+  \[in] A `COR_PRF_FRAME_INFO` value that points to information about the stack frame.
+
+  The profiler should treat this as an opaque handle that can be passed back to the execution engine in the [ICorProfilerInfo2::GetFunctionInfo2](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo2-getfunctioninfo2-method.md) method.  
 
+- `retvalRange`
+
+  \[in] A pointer to a [COR_PRF_FUNCTION_ARGUMENT_RANGE](../../../../docs/framework/unmanaged-api/profiling/cor-prf-function-argument-range-structure.md) structure that specifies the memory location of the function's return value.
+
+  In order to access return value information, the `COR_PRF_ENABLE_FUNCTION_RETVAL` flag must be set. The profiler can use the [ICorProfilerInfo::SetEventMask](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo-seteventmask-method.md) method to set the event flags.
+
 ## Remarks  
  The values of the `func` and `retvalRange` parameters are not valid after the `FunctionLeave2` function returns because the values may change or be destroyed.  
 

docs/framework/unmanaged-api/profiling/functionleave3-function.md

@@ -25,8 +25,10 @@ void __stdcall FunctionLeave3(FunctionOrRemappedID functionOrRemappedID);
 ```  
   
 ## Parameters  
- `functionOrRemappedID`  
- [in] The identifier of the function from which control is returned.  
+
+- `functionOrRemappedID`
+
+  \[in] The identifier of the function from which control is returned.
   
 ## Remarks  
  The `FunctionLeave3` callback function notifies the profiler as functions are being called, but does not support return value inspection. Use the [ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo3-setenterleavefunctionhooks3-method.md) to register your implementation of this function.  

docs/framework/unmanaged-api/profiling/functionleave3withinfo-function.md

@@ -26,13 +26,16 @@ void __stdcall FunctionLeave3WithInfo(
                [in] COR_PRF_ELT_INFO eltInfo);  
 ```  
   
-## Parameters  
- `functionIDOrClientID`  
- [in] The identifier of the function from which control is returned.  
-  
- `eltInfo`  
- [in] An opaque handle that represents information about a given stack frame. This handle is valid only during the callback to which it is passed.  
-  
+## Parameters
+
+- `functionIDOrClientID`
+
+  \[in] The identifier of the function from which control is returned.
+
+- `eltInfo`
+
+  \[in] An opaque handle that represents information about a given stack frame. This handle is valid only during the callback to which it is passed.
+
 ## Remarks  
  The `FunctionLeave3WithInfo` callback method notifies the profiler as functions are called, and allows the profiler to use the [ICorProfilerInfo3::GetFunctionLeave3Info method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo3-getfunctionleave3info-method.md) to inspect the return value. To access return value information, the `COR_PRF_ENABLE_FUNCTION_RETVAL` flag has to be set. The profiler can use the [ICorProfilerInfo::SetEventMask method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo-seteventmask-method.md) to set the event flags, and then use the [ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo method](../../../../docs/framework/unmanaged-api/profiling/icorprofilerinfo3-setenterleavefunctionhooks3withinfo-method.md) to register your implementation of this function.