Share via


GetFrame

The GetFrame function returns a handle to a given frame within a capture.

HFRAME WINAPIGetFrame(HCAPTUREhCapture,
DWORDFrameNumber);

Parameters

  • hCapture
    [in] Handle to a capture. To obtain the capture handle, call the GetFrameCaptureHandle function.
  • FrameNumber
    [in] Number (zero-based) of the frame. The number of the first frame in a capture is zero.

Return Values

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

If the function is unsuccessful (that is, if hCapture is invalid, or the frame number is out of range), the return value is NULL.

Remarks

Use the GetFrame function to obtain the frame handle needed when locating instances of a property. The functions used to locate property instances are FindPropertyInstance which locates the first instance, and FindPropertyInstanceRestart which locates the next instance.

Experts and parsers can call the GetFrame 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.

See Also

FindPropertyInstance, FindPropertyInstanceRestart