Share via


ModifyFrame

The ModifyFrame function alters an existing frame with new data.

HFRAME WINAPIModifyFrame(HCAPTUREhCapture,
DWORDFrameNumber,
LPBYTEFrameData,
DWORDFrameLength,
__int64TimeStamp);

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 Values

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

Client Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Header

Declared in Netmon.h.

Library

Link to Nmapi.lib.

DLL Requires Nmapi.dll.