In This Topic ▼

CaptureDIB Method

Summary

Captures a device independent bitmap.

Syntax

C++/CLI

public virtual IntPtr CaptureDIB()

public:  
   virtual System::IntPtr CaptureDIB()

Return Value

A System.IntPtr to the device independent bitmap.

Remarks

If the method succeeds, the caller must free the returned HDIB pointer by calling the Marshal.FreeHGlobal method. If the method fails, an error is raised. For more information, refer to the Error Codes.

Note:

Internally CaptureDIB calls StartCapture with the capture mode set to CaptureMode.Still. It then waits for the current capture delay setting specified by CaptureStillDelay before capturing the still DIB. Finally, it stops the graph by calling StopCapture.

The frame data is retrieved from the underlying graph after the processing filters. If the capture needs to occur before the processing is completed use the LeadVideoCallBackFilter and place it first in the collection of processing filters.

CaptureDIB uses long type casting for the underlying HDIB object, it is strongly recommended to use the newer version of this method CaptureHDIB that uses LONG_PTR casting.

Requirements

Target Platforms