MWCapture SDK Mac 3.4.62314

- Home
- Development Library
- Release Notes

Macros
Macros

## Macros
#define | INPUT_SOURCE(type, index) (((type) << 8) | ((index) & 0xFF))
| Defines audio or video input source.
#define | INPUT_TYPE(source) ((source) >> 8)
| Gets type variables from input source.
#define | INPUT_INDEX(source) ((source) & 0xFF)
| Gets input source index.
#define | MWCAP_NOTIFY_INPUT_SORUCE_START_SCAN 0x0001ULL
| MWCAP_NOTIFY_INPUT_SOURCE_START_SCAN.
#define | MWCAP_NOTIFY_INPUT_SORUCE_STOP_SCAN 0x0002ULL
| MWCAP_NOTIFY_INPUT_SOURCE_STOP_SCAN.
#define | MWCAP_NOTIFY_INPUT_SORUCE_SCAN_CHANGE 0x0003ULL
| MWCAP_NOTIFY_INPUT_SOURCE_SCAN_CHANGE.
#define | MWCAP_NOTIFY_VIDEO_INPUT_SOURCE_CHANGE 0x0004ULL
| MWCAP_NOTIFY_VIDEO_INPUT_SOURCE_CHANGE.
#define | MWCAP_NOTIFY_AUDIO_INPUT_SOURCE_CHANGE 0x0008ULL
| MWCAP_NOTIFY_AUDIO_INPUT_SOURCE_CHANGE.
#define | MWCAP_NOTIFY_INPUT_SPECIFIC_CHANGE 0x0010ULL
| MWCAP_NOTIFY_INPUT_SPECIFIC_CHANGE.
#define | MWCAP_NOTIFY_VIDEO_SIGNAL_CHANGE 0x0020ULL
| MWCAP_NOTIFY_VIDEO_SIGNAL_CHANGE.
#define | MWCAP_NOTIFY_AUDIO_SIGNAL_CHANGE 0x0040ULL
| MWCAP_NOTIFY_AUDIO_SIGNAL_CHANGE.
#define | MWCAP_NOTIFY_VIDEO_FIELD_BUFFERING 0x0080ULL
| MWCAP_NOTIFY_VIDEO_FIELD_BUFFERING.
#define | MWCAP_NOTIFY_VIDEO_FRAME_BUFFERING 0x0100ULL
| MWCAP_NOTIFY_VIDEO_FRAME_BUFFERING.
#define | MWCAP_NOTIFY_VIDEO_FIELD_BUFFERED 0x0200ULL
| MWCAP_NOTIFY_VIDEO_FIELD_BUFFERED.
#define | MWCAP_NOTIFY_VIDEO_FRAME_BUFFERED 0x0400ULL
| MWCAP_NOTIFY_VIDEO_FRAME_BUFFERED.
#define | MWCAP_NOTIFY_VIDEO_SMPTE_TIME_CODE 0x0800ULL
| MWCAP_NOTIFY_VIDEO_SMPTE_TIME_CODE.
#define | MWCAP_NOTIFY_AUDIO_FRAME_BUFFERED 0x1000ULL
| MWCAP_NOTIFY_AUDIO_FRAME_BUFFERED.
#define | MWCAP_NOTIFY_AUDIO_INPUT_RESET 0x2000ULL
| MWCAP_NOTIFY_AUDIO_INPUT_RESET.
#define | MWCAP_NOTIFY_VIDEO_SAMPLING_PHASE_CHANGE 0x4000ULL
| MWCAP_NOTIFY_VIDEO_SAMPLING_PHASE_CHANGE.
#define | MWCAP_NOTIFY_LOOP_THROUGH_CHANGED 0x8000ULL
| MWCAP_NOTIFY_LOOP_THROUGH_CHANGED.
#define | MWCAP_NOTIFY_LOOP_THROUGH_EDID_CHANGED 0x10000ULL
| MWCAP_NOTIFY_LOOP_THROUGH_EDID_CHANGED.
#define | MWCAP_NOTIFY_NEW_SDI_ANC_PACKET 0x20000ULL
| MWCAP_NOTIFY_NEW_SDI_ANC_PACKET.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_AVI (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_AVI))
| MWCAP_NOTIFY_HDMI_INFOFRAME_AVI.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_AUDIO (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_AUDIO))
| MWCAP_NOTIFY_HDMI_INFOFRAME_AUDIO.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_SPD (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_SPD))
| MWCAP_NOTIFY_HDMI_INFOFRAME_SPD.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_MS (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_MS))
| MWCAP_NOTIFY_HDMI_INFOFRAME_MS.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_VS (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_VS))
| MWCAP_NOTIFY_HDMI_INFOFRAME_VS.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_ACP (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_ACP))
| MWCAP_NOTIFY_HDMI_INFOFRAME_ACP.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC1 (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_ISRC1))
| MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC1.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC2 (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_ISRC2))
| MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC2.
#define | MWCAP_NOTIFY_HDMI_INFOFRAME_GAMUT (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_GAMUT))
| MWCAP_NOTIFY_HDMI_INFOFRAME_GAMUT.
#define | MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERED (-1)
| MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERED.
#define | MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERING (-2)
| MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERING.
#define | MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERED (-3)
| MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERED.
#define | MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERING (-4)
| MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERING.
#define | MWCAP_VIDEO_FRAME_ID_EMPTY (-100)
| MWCAP_VIDEO_FRAME_ID_EMPTY.
#define | MWCAP_VIDEO_PROCESS_FLIP 0x00000001
| MWCAP_VIDEO_PROCESS_FLIP.
#define | MWCAP_VIDEO_PROCESS_MIRROR 0x00000002
| MWCAP_VIDEO_PROCESS_MIRROR.
#define | MWCAP_AUDIO_SAMPLES_PER_FRAME 192
| MWCAP_AUDIO_SAMPLES_PER_FRAME.
#define | MWCAP_AUDIO_MAX_NUM_CHANNELS 8
| MWCAP_AUDIO_MAX_NUM_CHANNELS.
#define | MW_FIRMWARE_NAME_LEN 64
| MW_FIRMWARE_NAME_LEN.

## Detailed Description

## Macro Definition Documentation

## ◆ INPUT_INDEX

#define INPUT_INDEX | ( |  | source | ) | ((source) & 0xFF)

Gets input source index.

Parameters

  [in] | source | Input source

Extracting index variables from input sources

## ◆ INPUT_SOURCE

#define INPUT_SOURCE | ( |  | type,
|  |  | index
| ) |  | (((type) << 8) | ((index) & 0xFF))

Defines audio or video input source.

Parameters

  [in] | type | Input source type
  [in] | index | Index of input source

Defines the input source by the type and index. The audio input source type refers to MWCAP_AUDIO_INPUT_TYPE. The video input source type refers to MWCAP_VIDEO_INPUT_TYPE

## ◆ INPUT_TYPE

#define INPUT_TYPE | ( |  | source | ) | ((source) >> 8)

Gets type variables from input source.

Parameters

  [in] | source | Input source

Extracting type variables from input source

## ◆ MW_FIRMWARE_NAME_LEN

#define MW_FIRMWARE_NAME_LEN 64

MW_FIRMWARE_NAME_LEN.

Max length of firmware file name
Related type: MWCAP_CHANNEL_INFO

## ◆ MWCAP_AUDIO_MAX_NUM_CHANNELS

#define MWCAP_AUDIO_MAX_NUM_CHANNELS 8

MWCAP_AUDIO_MAX_NUM_CHANNELS.

Max audio channels
Related type:
MWCAP_AUDIO_CAPTURE_FRAME

## ◆ MWCAP_AUDIO_SAMPLES_PER_FRAME

#define MWCAP_AUDIO_SAMPLES_PER_FRAME 192

MWCAP_AUDIO_SAMPLES_PER_FRAME.

Sample numbers of every audio frame
Related type:
MWCAP_AUDIO_CAPTURE_FRAME

## ◆ MWCAP_NOTIFY_AUDIO_FRAME_BUFFERED

#define MWCAP_NOTIFY_AUDIO_FRAME_BUFFERED 0x1000ULL

MWCAP_NOTIFY_AUDIO_FRAME_BUFFERED.

Event notification. Audio frames have fully bufferred.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_AUDIO_INPUT_RESET

#define MWCAP_NOTIFY_AUDIO_INPUT_RESET 0x2000ULL

MWCAP_NOTIFY_AUDIO_INPUT_RESET.

Event notification. Audio input reset.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_AUDIO_INPUT_SOURCE_CHANGE

#define MWCAP_NOTIFY_AUDIO_INPUT_SOURCE_CHANGE 0x0008ULL

MWCAP_NOTIFY_AUDIO_INPUT_SOURCE_CHANGE.

Event notification. Audio input changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_AUDIO_SIGNAL_CHANGE

#define MWCAP_NOTIFY_AUDIO_SIGNAL_CHANGE 0x0040ULL

MWCAP_NOTIFY_AUDIO_SIGNAL_CHANGE.

Event notification. Audio signal changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_ACP

#define MWCAP_NOTIFY_HDMI_INFOFRAME_ACP (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_ACP))

MWCAP_NOTIFY_HDMI_INFOFRAME_ACP.

Event notification. ACP infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_AUDIO

#define MWCAP_NOTIFY_HDMI_INFOFRAME_AUDIO (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_AUDIO))

MWCAP_NOTIFY_HDMI_INFOFRAME_AUDIO.

Event notification. Audio infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_AVI

#define MWCAP_NOTIFY_HDMI_INFOFRAME_AVI (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_AVI))

MWCAP_NOTIFY_HDMI_INFOFRAME_AVI.

Event notification. AVI infoframe is changing.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_GAMUT

#define MWCAP_NOTIFY_HDMI_INFOFRAME_GAMUT (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_GAMUT))

MWCAP_NOTIFY_HDMI_INFOFRAME_GAMUT.

Event notification. GAMUT infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC1

#define MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC1 (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_ISRC1))

MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC1.

Event notification. ISRC1 infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC2

#define MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC2 (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_ISRC2))

MWCAP_NOTIFY_HDMI_INFOFRAME_ISRC2.

Event notification. ISRC2 infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_MS

#define MWCAP_NOTIFY_HDMI_INFOFRAME_MS (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_MS))

MWCAP_NOTIFY_HDMI_INFOFRAME_MS.

Event notification. MS infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_SPD

#define MWCAP_NOTIFY_HDMI_INFOFRAME_SPD (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_SPD))

MWCAP_NOTIFY_HDMI_INFOFRAME_SPD.

Event notification. SPD infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_HDMI_INFOFRAME_VS

#define MWCAP_NOTIFY_HDMI_INFOFRAME_VS (1ULL << (32 + MWCAP_HDMI_INFOFRAME_ID_VS))

MWCAP_NOTIFY_HDMI_INFOFRAME_VS.

Event notification. VS infoframe changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_INPUT_SORUCE_SCAN_CHANGE

#define MWCAP_NOTIFY_INPUT_SORUCE_SCAN_CHANGE 0x0003ULL

MWCAP_NOTIFY_INPUT_SOURCE_SCAN_CHANGE.

Event notification. Scan video input source status changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_INPUT_SORUCE_START_SCAN

#define MWCAP_NOTIFY_INPUT_SORUCE_START_SCAN 0x0001ULL

MWCAP_NOTIFY_INPUT_SOURCE_START_SCAN.

Event notification. Start scanning the input source.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_INPUT_SORUCE_STOP_SCAN

#define MWCAP_NOTIFY_INPUT_SORUCE_STOP_SCAN 0x0002ULL

MWCAP_NOTIFY_INPUT_SOURCE_STOP_SCAN.

Event notification. Stop scanning the input source.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_INPUT_SPECIFIC_CHANGE

#define MWCAP_NOTIFY_INPUT_SPECIFIC_CHANGE 0x0010ULL

MWCAP_NOTIFY_INPUT_SPECIFIC_CHANGE.

Event notification. Detailed format of input video changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_LOOP_THROUGH_CHANGED

#define MWCAP_NOTIFY_LOOP_THROUGH_CHANGED 0x8000ULL

MWCAP_NOTIFY_LOOP_THROUGH_CHANGED.

Event notification. The state of loopthrough interface changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_LOOP_THROUGH_EDID_CHANGED

#define MWCAP_NOTIFY_LOOP_THROUGH_EDID_CHANGED 0x10000ULL

MWCAP_NOTIFY_LOOP_THROUGH_EDID_CHANGED.

Event notification. EDID of loopthrough changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_NEW_SDI_ANC_PACKET

#define MWCAP_NOTIFY_NEW_SDI_ANC_PACKET 0x20000ULL

MWCAP_NOTIFY_NEW_SDI_ANC_PACKET.

Event notification. New ANC packets.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_FIELD_BUFFERED

#define MWCAP_NOTIFY_VIDEO_FIELD_BUFFERED 0x0200ULL

MWCAP_NOTIFY_VIDEO_FIELD_BUFFERED.

Event notification. Video field has fully buffered.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_FIELD_BUFFERING

#define MWCAP_NOTIFY_VIDEO_FIELD_BUFFERING 0x0080ULL

MWCAP_NOTIFY_VIDEO_FIELD_BUFFERING.

Event notification. Video field is buffering.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_FRAME_BUFFERED

#define MWCAP_NOTIFY_VIDEO_FRAME_BUFFERED 0x0400ULL

MWCAP_NOTIFY_VIDEO_FRAME_BUFFERED.

Event notification. Video frame has fully buffered.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_FRAME_BUFFERING

#define MWCAP_NOTIFY_VIDEO_FRAME_BUFFERING 0x0100ULL

MWCAP_NOTIFY_VIDEO_FRAME_BUFFERING.

Event notification. Video frame is buffering.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_INPUT_SOURCE_CHANGE

#define MWCAP_NOTIFY_VIDEO_INPUT_SOURCE_CHANGE 0x0004ULL

MWCAP_NOTIFY_VIDEO_INPUT_SOURCE_CHANGE.

Event notification. Video input changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_SAMPLING_PHASE_CHANGE

#define MWCAP_NOTIFY_VIDEO_SAMPLING_PHASE_CHANGE 0x4000ULL

MWCAP_NOTIFY_VIDEO_SAMPLING_PHASE_CHANGE.

Event notification. Video sample phase changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_SIGNAL_CHANGE

#define MWCAP_NOTIFY_VIDEO_SIGNAL_CHANGE 0x0020ULL

MWCAP_NOTIFY_VIDEO_SIGNAL_CHANGE.

Event notification. Format of input video changed.
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_NOTIFY_VIDEO_SMPTE_TIME_CODE

#define MWCAP_NOTIFY_VIDEO_SMPTE_TIME_CODE 0x0800ULL

MWCAP_NOTIFY_VIDEO_SMPTE_TIME_CODE.

Event notification. SMPTE time code
Related functions are:
MWRegisterNotify
MWUnregisterNotify

## ◆ MWCAP_VIDEO_FRAME_ID_EMPTY

#define MWCAP_VIDEO_FRAME_ID_EMPTY (-100)

MWCAP_VIDEO_FRAME_ID_EMPTY.

Frame ID is empty
Related type: MWCAP_VIDEO_CAPTURE_STATUS

## ◆ MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERED

#define MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERED (-1)

MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERED.

The latest buffered frame ID
Related functions are:
MWCaptureVideoFrameToVirtualAddress
MWCaptureVideoFrameToPhysicalAddress
MWCaptureVideoFrameWithOSDToVirtualAddress
MWCaptureVideoFrameWithOSDToPhysicalAddress
MWCaptureVideoFrameToVirtualAddressEx
MWCaptureVideoFrameToPhysicalAddressEx

## ◆ MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERING

#define MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERING (-2)

MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERING.

The latest bufferring frame ID
Related functions are:
MWCaptureVideoFrameToVirtualAddress
MWCaptureVideoFrameToPhysicalAddress
MWCaptureVideoFrameWithOSDToVirtualAddress
MWCaptureVideoFrameWithOSDToPhysicalAddress
MWCaptureVideoFrameToVirtualAddressEx
MWCaptureVideoFrameToPhysicalAddressEx

## ◆ MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERED

#define MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERED (-3)

MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERED.

The next bufferred frame ID
Related functions are:
MWCaptureVideoFrameToVirtualAddress
MWCaptureVideoFrameToPhysicalAddress
MWCaptureVideoFrameWithOSDToVirtualAddress
MWCaptureVideoFrameWithOSDToPhysicalAddress
MWCaptureVideoFrameToVirtualAddressEx
MWCaptureVideoFrameToPhysicalAddressEx

## ◆ MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERING

#define MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERING (-4)

MWCAP_VIDEO_FRAME_ID_NEXT_BUFFERING.

The next bufferring frame ID
Related functions are:
MWCaptureVideoFrameToVirtualAddress
MWCaptureVideoFrameToPhysicalAddress
MWCaptureVideoFrameWithOSDToVirtualAddress
MWCaptureVideoFrameWithOSDToPhysicalAddress
MWCaptureVideoFrameToVirtualAddressEx
MWCaptureVideoFrameToPhysicalAddressEx

## ◆ MWCAP_VIDEO_PROCESS_FLIP

#define MWCAP_VIDEO_PROCESS_FLIP 0x00000001

MWCAP_VIDEO_PROCESS_FLIP.

Flip video images Up-side-down Related type: MWCAP_VIDEO_PROCESS_SETTINGS

## ◆ MWCAP_VIDEO_PROCESS_MIRROR

#define MWCAP_VIDEO_PROCESS_MIRROR 0x00000002

MWCAP_VIDEO_PROCESS_MIRROR.

Flip video images left to right
Related type: MWCAP_VIDEO_PROCESS_SETTINGS