ModifyFrame function

Article
01/07/2021

The ModifyFrame function alters an existing frame with new data.

Syntax

HFRAME WINAPI ModifyFrame(
  _In_  HCAPTURE hCapture,
  _In_  DWORD    FrameNumber,
  _In_  LPBYTE   FrameData,
  _In_  DWORD    FrameLength,
  _Out_ __int64  TimeStamp
);

Parameters

hCapture [in]: Handle to the capture. For information about obtaining the capture handle, see the Remarks section of this ModifyFrame topic.
FrameNumber [in]: Frame index number.
FrameData [in]: Pointer to an array of bytes that contain the new frame data.
FrameLength [in]: Length of the new data, in bytes.
TimeStamp [out]: Time stamp indicating when the frame was modified.

Return value

If the function is successful, the return value is a handle to a new frame.

If the function is unsuccessful, the return value is NULL.

Remarks

If the call is successful, the ModifyFrame function destroys the original frame.

Experts and parsers can call the ModifyFrame function.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Netmon.h
Library	Nmapi.lib
DLL	Nmapi.dll

Share via