New upstream version 23.2.1+dfsg1

This commit is contained in:
Simon Chopin 2019-07-27 14:47:10 +02:00
parent cdc9a9fc87
commit b14f9eae6d
1017 changed files with 37232 additions and 11111 deletions

View file

@ -1,5 +1,5 @@
/* -LICENSE-START-
** Copyright (c) 2016 Blackmagic Design
** Copyright (c) 2018 Blackmagic Design
**
** Permission is hereby granted, free of charge, to any person or organization
** obtaining a copy of the software and accompanying documentation covered by
@ -7,14 +7,14 @@
** execute, and transmit the Software, and to prepare derivative works of the
** Software, and to permit third-parties to whom the Software is furnished to
** do so, all subject to the following:
**
**
** The copyright notices in the Software and this entire statement, including
** the above license grant, this restriction and the following disclaimer,
** must be included in all copies of the Software, in whole or in part, and
** all derivative works of the Software, unless such copies or derivative
** works are solely in the form of machine-executable object code generated by
** a source language processor.
**
**
** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
** IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
** FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
@ -95,9 +95,11 @@ typedef [v1_enum] enum _BMDPacketType {
bmdFrameFlagDefault = 0,
bmdFrameFlagFlipVertical = 1 << 0,
bmdFrameContainsHDRMetadata = 1 << 1,
bmdFrameContainsCintelMetadata = 1 << 2,
/* Flags that are applicable only to instances of IDeckLinkVideoInputFrame */
bmdFrameCapturedAsPsF = 1 << 30,
bmdFrameHasNoInputSource = 1 << 31
};
@ -136,10 +138,10 @@ typedef [v1_enum] enum _BMDPacketType {
/* Enum BMDOutputFrameCompletionResult - Frame Completion Callback */
typedef [v1_enum] enum _BMDOutputFrameCompletionResult {
bmdOutputFrameCompleted,
bmdOutputFrameDisplayedLate,
bmdOutputFrameDropped,
bmdOutputFrameFlushed
bmdOutputFrameCompleted,
bmdOutputFrameDisplayedLate,
bmdOutputFrameDropped,
bmdOutputFrameFlushed
} BMDOutputFrameCompletionResult;
/* Enum BMDReferenceStatus - GenLock input status */
@ -171,19 +173,27 @@ typedef [v1_enum] enum _BMDAudioSampleType {
/* Enum BMDAudioOutputStreamType - Audio output stream type */
typedef [v1_enum] enum _BMDAudioOutputStreamType {
bmdAudioOutputStreamContinuous,
bmdAudioOutputStreamContinuousDontResample,
bmdAudioOutputStreamTimestamped
bmdAudioOutputStreamContinuous,
bmdAudioOutputStreamContinuousDontResample,
bmdAudioOutputStreamTimestamped
} BMDAudioOutputStreamType;
/* Enum BMDDisplayModeSupport - Output mode supported flags */
typedef [v1_enum] enum _BMDDisplayModeSupport {
bmdDisplayModeNotSupported = 0,
bmdDisplayModeSupported,
bmdDisplayModeSupportedWithConversion
bmdDisplayModeSupported,
bmdDisplayModeSupportedWithConversion
} BMDDisplayModeSupport;
/* Enum BMDAncillaryPacketFormat - Ancillary packet format */
typedef [v1_enum] enum _BMDAncillaryPacketFormat {
bmdAncillaryPacketFormatUInt8 = /* 'ui08' */ 0x75693038,
bmdAncillaryPacketFormatUInt16 = /* 'ui16' */ 0x75693136,
bmdAncillaryPacketFormatYCbCr10 = /* 'v210' */ 0x76323130
} BMDAncillaryPacketFormat;
/* Enum BMDTimecodeFormat - Timecode formats for frame metadata */
typedef [v1_enum] enum _BMDTimecodeFormat {
@ -292,10 +302,64 @@ typedef [v1_enum] enum _BMDDeviceInterface {
bmdDeviceInterfaceThunderbolt = /* 'thun' */ 0x7468756E
} BMDDeviceInterface;
/* Enum BMDColorspace - Colorspace */
typedef [v1_enum] enum _BMDColorspace {
bmdColorspaceRec601 = /* 'r601' */ 0x72363031,
bmdColorspaceRec709 = /* 'r709' */ 0x72373039,
bmdColorspaceRec2020 = /* '2020' */ 0x32303230
} BMDColorspace;
/* Enum BMDDynamicRange - SDR or HDR */
typedef [v1_enum] enum _BMDDynamicRange {
bmdDynamicRangeSDR = 0,
bmdDynamicRangeHDRStaticPQ = 1 << 29, // SMPTE ST 2084
bmdDynamicRangeHDRStaticHLG = 1 << 30 // ITU-R BT.2100-0
} BMDDynamicRange;
/* Enum BMDDeckLinkHDMIInputEDIDID - DeckLink HDMI Input EDID ID */
typedef [v1_enum] enum _BMDDeckLinkHDMIInputEDIDID {
bmdDeckLinkHDMIInputEDIDDynamicRange = /* 'HIDy' */ 0x48494479 // Parameter is of type BMDDynamicRange. Default is (bmdDynamicRangeSDR|bmdDynamicRangeHDRStaticPQ)
} BMDDeckLinkHDMIInputEDIDID;
/* Enum BMDDeckLinkFrameMetadataID - DeckLink Frame Metadata ID */
typedef [v1_enum] enum _BMDDeckLinkFrameMetadataID {
bmdDeckLinkFrameMetadataColorspace = /* 'cspc' */ 0x63737063, // Colorspace of video frame (see BMDColorspace)
bmdDeckLinkFrameMetadataHDRElectroOpticalTransferFunc = /* 'eotf' */ 0x656F7466, // EOTF in range 0-7 as per CEA 861.3
bmdDeckLinkFrameMetadataCintelFilmType = /* 'cfty' */ 0x63667479, // Current film type
bmdDeckLinkFrameMetadataCintelFilmGauge = /* 'cfga' */ 0x63666761, // Current film gauge
bmdDeckLinkFrameMetadataCintelOffsetDetectedHorizontal = /* 'odfh' */ 0x6F646668, // Horizontal offset (pixels) detected in image
bmdDeckLinkFrameMetadataCintelOffsetDetectedVertical = /* 'odfv' */ 0x6F646676, // Vertical offset (pixels) detected in image
bmdDeckLinkFrameMetadataCintelKeykodeLow = /* 'ckkl' */ 0x636B6B6C, // Raw keykode value - low 64 bits
bmdDeckLinkFrameMetadataCintelKeykodeHigh = /* 'ckkh' */ 0x636B6B68, // Raw keykode value - high 64 bits
bmdDeckLinkFrameMetadataCintelTile1Size = /* 'ct1s' */ 0x63743173, // Size in bytes of compressed raw tile 1
bmdDeckLinkFrameMetadataCintelTile2Size = /* 'ct2s' */ 0x63743273, // Size in bytes of compressed raw tile 2
bmdDeckLinkFrameMetadataCintelTile3Size = /* 'ct3s' */ 0x63743373, // Size in bytes of compressed raw tile 3
bmdDeckLinkFrameMetadataCintelTile4Size = /* 'ct4s' */ 0x63743473, // Size in bytes of compressed raw tile 4
bmdDeckLinkFrameMetadataCintelImageWidth = /* 'IWPx' */ 0x49575078, // Width in pixels of image
bmdDeckLinkFrameMetadataCintelImageHeight = /* 'IHPx' */ 0x49485078, // Height in pixels of image
bmdDeckLinkFrameMetadataCintelLinearMaskingRedInRed = /* 'mrir' */ 0x6D726972, // Red in red linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingGreenInRed = /* 'mgir' */ 0x6D676972, // Green in red linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingBlueInRed = /* 'mbir' */ 0x6D626972, // Blue in red linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingRedInGreen = /* 'mrig' */ 0x6D726967, // Red in green linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingGreenInGreen = /* 'mgig' */ 0x6D676967, // Green in green linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingBlueInGreen = /* 'mbig' */ 0x6D626967, // Blue in green linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingRedInBlue = /* 'mrib' */ 0x6D726962, // Red in blue linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingGreenInBlue = /* 'mgib' */ 0x6D676962, // Green in blue linear masking parameter
bmdDeckLinkFrameMetadataCintelLinearMaskingBlueInBlue = /* 'mbib' */ 0x6D626962, // Blue in blue linear masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingRedInRed = /* 'mlrr' */ 0x6D6C7272, // Red in red log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingGreenInRed = /* 'mlgr' */ 0x6D6C6772, // Green in red log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingBlueInRed = /* 'mlbr' */ 0x6D6C6272, // Blue in red log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingRedInGreen = /* 'mlrg' */ 0x6D6C7267, // Red in green log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingGreenInGreen = /* 'mlgg' */ 0x6D6C6767, // Green in green log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingBlueInGreen = /* 'mlbg' */ 0x6D6C6267, // Blue in green log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingRedInBlue = /* 'mlrb' */ 0x6D6C7262, // Red in blue log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingGreenInBlue = /* 'mlgb' */ 0x6D6C6762, // Green in blue log masking parameter
bmdDeckLinkFrameMetadataCintelLogMaskingBlueInBlue = /* 'mlbb' */ 0x6D6C6262, // Blue in blue log masking parameter
bmdDeckLinkFrameMetadataCintelFilmFrameRate = /* 'cffr' */ 0x63666672, // Film frame rate
bmdDeckLinkFrameMetadataHDRDisplayPrimariesRedX = /* 'hdrx' */ 0x68647278, // Red display primaries in range 0.0 - 1.0
bmdDeckLinkFrameMetadataHDRDisplayPrimariesRedY = /* 'hdry' */ 0x68647279, // Red display primaries in range 0.0 - 1.0
bmdDeckLinkFrameMetadataHDRDisplayPrimariesGreenX = /* 'hdgx' */ 0x68646778, // Green display primaries in range 0.0 - 1.0
@ -307,7 +371,15 @@ typedef [v1_enum] enum _BMDDeckLinkFrameMetadataID {
bmdDeckLinkFrameMetadataHDRMaxDisplayMasteringLuminance = /* 'hdml' */ 0x68646D6C, // Max display mastering luminance in range 1 cd/m2 - 65535 cd/m2
bmdDeckLinkFrameMetadataHDRMinDisplayMasteringLuminance = /* 'hmil' */ 0x686D696C, // Min display mastering luminance in range 0.0001 cd/m2 - 6.5535 cd/m2
bmdDeckLinkFrameMetadataHDRMaximumContentLightLevel = /* 'mcll' */ 0x6D636C6C, // Maximum Content Light Level in range 1 cd/m2 - 65535 cd/m2
bmdDeckLinkFrameMetadataHDRMaximumFrameAverageLightLevel = /* 'fall' */ 0x66616C6C // Maximum Frame Average Light Level in range 1 cd/m2 - 65535 cd/m2
bmdDeckLinkFrameMetadataHDRMaximumFrameAverageLightLevel = /* 'fall' */ 0x66616C6C, // Maximum Frame Average Light Level in range 1 cd/m2 - 65535 cd/m2
bmdDeckLinkFrameMetadataCintelOffsetToApplyHorizontal = /* 'otah' */ 0x6F746168, // Horizontal offset (pixels) to be applied to image
bmdDeckLinkFrameMetadataCintelOffsetToApplyVertical = /* 'otav' */ 0x6F746176, // Vertical offset (pixels) to be applied to image
bmdDeckLinkFrameMetadataCintelGainRed = /* 'LfRd' */ 0x4C665264, // Red gain parameter to apply after log
bmdDeckLinkFrameMetadataCintelGainGreen = /* 'LfGr' */ 0x4C664772, // Green gain parameter to apply after log
bmdDeckLinkFrameMetadataCintelGainBlue = /* 'LfBl' */ 0x4C66426C, // Blue gain parameter to apply after log
bmdDeckLinkFrameMetadataCintelLiftRed = /* 'GnRd' */ 0x476E5264, // Red lift parameter to apply after log and gain
bmdDeckLinkFrameMetadataCintelLiftGreen = /* 'GnGr' */ 0x476E4772, // Green lift parameter to apply after log and gain
bmdDeckLinkFrameMetadataCintelLiftBlue = /* 'GnBl' */ 0x476E426C // Blue lift parameter to apply after log and gain
} BMDDeckLinkFrameMetadataID;
/* Enum BMDDuplexMode - Duplex for configurable ports */
@ -343,22 +415,24 @@ typedef [v1_enum] enum _BMDDeckLinkAttributeID {
BMDDeckLinkHasLTCTimecodeInput = /* 'hltc' */ 0x686C7463,
BMDDeckLinkSupportsDuplexModeConfiguration = /* 'dupx' */ 0x64757078,
BMDDeckLinkSupportsHDRMetadata = /* 'hdrm' */ 0x6864726D,
BMDDeckLinkSupportsColorspaceMetadata = /* 'cmet' */ 0x636D6574,
/* Integers */
BMDDeckLinkMaximumAudioChannels = /* 'mach' */ 0x6D616368,
BMDDeckLinkMaximumAnalogAudioChannels = /* 'aach' */ 0x61616368,
BMDDeckLinkMaximumAnalogAudioInputChannels = /* 'iach' */ 0x69616368,
BMDDeckLinkMaximumAnalogAudioOutputChannels = /* 'aach' */ 0x61616368,
BMDDeckLinkNumberOfSubDevices = /* 'nsbd' */ 0x6E736264,
BMDDeckLinkSubDeviceIndex = /* 'subi' */ 0x73756269,
BMDDeckLinkPersistentID = /* 'peid' */ 0x70656964,
BMDDeckLinkDeviceGroupID = /* 'dgid' */ 0x64676964,
BMDDeckLinkTopologicalID = /* 'toid' */ 0x746F6964,
BMDDeckLinkVideoOutputConnections = /* 'vocn' */ 0x766F636E,
BMDDeckLinkVideoInputConnections = /* 'vicn' */ 0x7669636E,
BMDDeckLinkAudioOutputConnections = /* 'aocn' */ 0x616F636E,
BMDDeckLinkAudioInputConnections = /* 'aicn' */ 0x6169636E,
BMDDeckLinkVideoOutputConnections = /* 'vocn' */ 0x766F636E, // Returns a BMDVideoConnection bit field
BMDDeckLinkVideoInputConnections = /* 'vicn' */ 0x7669636E, // Returns a BMDVideoConnection bit field
BMDDeckLinkAudioOutputConnections = /* 'aocn' */ 0x616F636E, // Returns a BMDAudioConnection bit field
BMDDeckLinkAudioInputConnections = /* 'aicn' */ 0x6169636E, // Returns a BMDAudioConnection bit field
BMDDeckLinkVideoIOSupport = /* 'vios' */ 0x76696F73, // Returns a BMDVideoIOSupport bit field
BMDDeckLinkDeckControlConnections = /* 'dccn' */ 0x6463636E,
BMDDeckLinkDeckControlConnections = /* 'dccn' */ 0x6463636E, // Returns a BMDDeckControlConnection bit field
BMDDeckLinkDeviceInterface = /* 'dbus' */ 0x64627573, // Returns a BMDDeviceInterface
BMDDeckLinkAudioInputRCAChannelCount = /* 'airc' */ 0x61697263,
BMDDeckLinkAudioInputXLRChannelCount = /* 'aixc' */ 0x61697863,
@ -410,11 +484,14 @@ typedef [v1_enum] enum _BMDDeckLinkStatusID {
bmdDeckLinkStatusReferenceSignalFlags = /* 'reff' */ 0x72656666,
bmdDeckLinkStatusDuplexMode = /* 'dupx' */ 0x64757078,
bmdDeckLinkStatusBusy = /* 'busy' */ 0x62757379,
bmdDeckLinkStatusInterchangeablePanelType = /* 'icpt' */ 0x69637074,
bmdDeckLinkStatusDeviceTemperature = /* 'dtmp' */ 0x64746D70,
/* Flags */
bmdDeckLinkStatusVideoInputSignalLocked = /* 'visl' */ 0x7669736C,
bmdDeckLinkStatusReferenceSignalLocked = /* 'refl' */ 0x7265666C
bmdDeckLinkStatusReferenceSignalLocked = /* 'refl' */ 0x7265666C,
bmdDeckLinkStatusReceivedEDID = /* 'edid' */ 0x65646964
} BMDDeckLinkStatusID;
/* Enum BMDDeckLinkVideoStatusFlags - */
@ -433,6 +510,13 @@ typedef [v1_enum] enum _BMDDuplexStatus {
bmdDuplexStatusInactive = /* 'inac' */ 0x696E6163
} BMDDuplexStatus;
/* Enum BMDPanelType - The type of interchangeable panel */
typedef [v1_enum] enum _BMDPanelType {
bmdPanelNotDetected = /* 'npnl' */ 0x6E706E6C,
bmdPanelTeranexMiniSmartPanel = /* 'tmsm' */ 0x746D736D
} BMDPanelType;
/* Enum BMDDeviceBusyState - Current device busy state */
[v1_enum] enum _BMDDeviceBusyState {
@ -476,12 +560,16 @@ interface IDeckLinkIterator;
interface IDeckLinkAPIInformation;
interface IDeckLinkOutput;
interface IDeckLinkInput;
interface IDeckLinkHDMIInputEDID;
interface IDeckLinkEncoderInput;
interface IDeckLinkVideoFrame;
interface IDeckLinkMutableVideoFrame;
interface IDeckLinkVideoFrame3DExtensions;
interface IDeckLinkVideoFrameMetadataExtensions;
interface IDeckLinkVideoInputFrame;
interface IDeckLinkAncillaryPacket;
interface IDeckLinkAncillaryPacketIterator;
interface IDeckLinkVideoFrameAncillaryPackets;
interface IDeckLinkVideoFrameAncillary;
interface IDeckLinkEncoderPacket;
interface IDeckLinkEncoderVideoPacket;
@ -542,7 +630,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(B36EB6E7-9D29-4AA8-92EF-843B87A289E8),
local,
local,
helpstring("Memory allocator for video frames.")
] interface IDeckLinkMemoryAllocator : IUnknown
{
@ -558,7 +646,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(403C681B-7F46-4A12-B993-2BB127084EE6),
local,
local,
helpstring("Optional callback to allow audio samples to be pulled as required.")
] interface IDeckLinkAudioOutputCallback : IUnknown
{
@ -595,7 +683,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(CC5C8A6E-3F2F-4B3A-87EA-FD78AF300564),
local,
local,
helpstring("Created by QueryInterface from IDeckLink.")
] interface IDeckLinkOutput : IUnknown
{
@ -611,7 +699,7 @@ interface IDeckLinkDiscovery;
HRESULT SetVideoOutputFrameMemoryAllocator([in] IDeckLinkMemoryAllocator *theAllocator);
HRESULT CreateVideoFrame([in] int width, [in] int height, [in] int rowBytes, [in] BMDPixelFormat pixelFormat, [in] BMDFrameFlags flags, [out] IDeckLinkMutableVideoFrame **outFrame);
HRESULT CreateAncillaryData([in] BMDPixelFormat pixelFormat, [out] IDeckLinkVideoFrameAncillary **outBuffer);
HRESULT CreateAncillaryData([in] BMDPixelFormat pixelFormat, [out] IDeckLinkVideoFrameAncillary **outBuffer); // Use of IDeckLinkVideoFrameAncillaryPackets is preferred
HRESULT DisplayVideoFrameSync([in] IDeckLinkVideoFrame *theFrame);
HRESULT ScheduleVideoFrame([in] IDeckLinkVideoFrame *theFrame, [in] BMDTimeValue displayTime, [in] BMDTimeValue displayDuration, [in] BMDTimeScale timeScale);
@ -687,6 +775,19 @@ interface IDeckLinkDiscovery;
HRESULT GetHardwareReferenceClock([in] BMDTimeScale desiredTimeScale, [out] BMDTimeValue *hardwareTime, [out] BMDTimeValue *timeInFrame, [out] BMDTimeValue *ticksPerFrame);
};
/* Interface IDeckLinkHDMIInputEDID - Created by QueryInterface from IDeckLink. Releasing all references will restore EDID to default */
[
object,
uuid(ABBBACBC-45BC-4665-9D92-ACE6E5A97902),
helpstring("Created by QueryInterface from IDeckLink. Releasing all references will restore EDID to default")
] interface IDeckLinkHDMIInputEDID : IUnknown
{
HRESULT SetInt([in] BMDDeckLinkHDMIInputEDIDID cfgID, [in] LONGLONG value);
HRESULT GetInt([in] BMDDeckLinkHDMIInputEDIDID cfgID, [out] LONGLONG *value);
HRESULT WriteToEDID(void);
};
/* Interface IDeckLinkEncoderInput - Created by QueryInterface from IDeckLink. */
[
@ -729,7 +830,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(3F716FE0-F023-4111-BE5D-EF4414C05B17),
local,
local,
helpstring("Interface to encapsulate a video frame; can be caller-implemented.")
] interface IDeckLinkVideoFrame : IUnknown
{
@ -741,7 +842,7 @@ interface IDeckLinkDiscovery;
HRESULT GetBytes([out] void **buffer);
HRESULT GetTimecode([in] BMDTimecodeFormat format, [out] IDeckLinkTimecode **timecode);
HRESULT GetAncillaryData([out] IDeckLinkVideoFrameAncillary **ancillary);
HRESULT GetAncillaryData([out] IDeckLinkVideoFrameAncillary **ancillary); // Use of IDeckLinkVideoFrameAncillaryPackets is preferred
};
/* Interface IDeckLinkMutableVideoFrame - Created by IDeckLinkOutput::CreateVideoFrame. */
@ -749,7 +850,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(69E2639F-40DA-4E19-B6F2-20ACE815C390),
local,
local,
helpstring("Created by IDeckLinkOutput::CreateVideoFrame.")
] interface IDeckLinkMutableVideoFrame : IDeckLinkVideoFrame
{
@ -766,7 +867,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(DA0F7E4A-EDC7-48A8-9CDD-2DB51C729CD7),
local,
local,
helpstring("Optional interface implemented on IDeckLinkVideoFrame to support 3D frames")
] interface IDeckLinkVideoFrame3DExtensions : IUnknown
{
@ -779,7 +880,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(D5973DC9-6432-46D0-8F0B-2496F8A1238F),
local,
local,
helpstring("Optional interface implemented on IDeckLinkVideoFrame to support frame metadata such as HDMI HDR information")
] interface IDeckLinkVideoFrameMetadataExtensions : IUnknown
{
@ -794,7 +895,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(05CFE374-537C-4094-9A57-680525118F44),
local,
local,
helpstring("Provided by the IDeckLinkVideoInput frame arrival callback.")
] interface IDeckLinkVideoInputFrame : IDeckLinkVideoFrame
{
@ -802,17 +903,61 @@ interface IDeckLinkDiscovery;
HRESULT GetHardwareReferenceTimestamp([in] BMDTimeScale timeScale, [out] BMDTimeValue *frameTime, [out] BMDTimeValue *frameDuration);
};
/* Interface IDeckLinkVideoFrameAncillary - Obtained through QueryInterface() on an IDeckLinkVideoFrame object. */
/* Interface IDeckLinkAncillaryPacket - On output, user needs to implement this interface */
[
object,
uuid(CC5BBF7E-029C-4D3B-9158-6000EF5E3670),
helpstring("On output, user needs to implement this interface")
] interface IDeckLinkAncillaryPacket : IUnknown
{
HRESULT GetBytes([in] BMDAncillaryPacketFormat format /* For output, only one format need be offered */, [out] const void **data /* Optional */, [out] unsigned int *size /* Optional */);
unsigned char GetDID(void);
unsigned char GetSDID(void);
unsigned int GetLineNumber(void); // On output, zero is auto
unsigned char GetDataStreamIndex(void); // Usually zero. Can only be 1 if non-SD and the first data stream is completely full
};
/* Interface IDeckLinkAncillaryPacketIterator - Enumerates ancillary packets */
[
object,
uuid(3FC8994B-88FB-4C17-968F-9AAB69D964A7),
helpstring("Enumerates ancillary packets")
] interface IDeckLinkAncillaryPacketIterator : IUnknown
{
HRESULT Next([out] IDeckLinkAncillaryPacket **packet);
};
/* Interface IDeckLinkVideoFrameAncillaryPackets - Obtained through QueryInterface() on an IDeckLinkVideoFrame object. */
[
object,
uuid(6C186C0F-459E-41D8-AEE2-4812D81AEE68),
local,
helpstring("Obtained through QueryInterface() on an IDeckLinkVideoFrame object.")
] interface IDeckLinkVideoFrameAncillaryPackets : IUnknown
{
HRESULT GetPacketIterator([out] IDeckLinkAncillaryPacketIterator **iterator);
HRESULT GetFirstPacketByID([in] unsigned char DID, [in] unsigned char SDID, [out] IDeckLinkAncillaryPacket **packet);
HRESULT AttachPacket([in] IDeckLinkAncillaryPacket *packet); // Implement IDeckLinkAncillaryPacket to output your own
HRESULT DetachPacket([in] IDeckLinkAncillaryPacket *packet);
HRESULT DetachAllPackets(void);
};
/* Interface IDeckLinkVideoFrameAncillary - Use of IDeckLinkVideoFrameAncillaryPackets is preferred. Obtained through QueryInterface() on an IDeckLinkVideoFrame object. */
[
object,
uuid(732E723C-D1A4-4E29-9E8E-4A88797A0004),
local,
helpstring("Obtained through QueryInterface() on an IDeckLinkVideoFrame object.")
local,
helpstring("Use of IDeckLinkVideoFrameAncillaryPackets is preferred. Obtained through QueryInterface() on an IDeckLinkVideoFrame object.")
] interface IDeckLinkVideoFrameAncillary : IUnknown
{
HRESULT GetBufferForVerticalBlankingLine([in] unsigned int lineNumber, [out] void **buffer);
HRESULT GetBufferForVerticalBlankingLine([in] unsigned int lineNumber, [out] void **buffer); // Pixels/rowbytes is same as display mode, except for above HD where it's 1920 pixels for UHD modes and 2048 pixels for DCI modes
BMDPixelFormat GetPixelFormat(void);
BMDDisplayMode GetDisplayMode(void);
};
@ -822,7 +967,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(B693F36C-316E-4AF1-B6C2-F389A4BCA620),
local,
local,
helpstring("Interface to encapsulate an encoded packet.")
] interface IDeckLinkEncoderPacket : IUnknown
{
@ -837,7 +982,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(4E7FD944-E8C7-4EAC-B8C0-7B77F80F5AE0),
local,
local,
helpstring("Provided by the IDeckLinkEncoderInput video packet arrival callback.")
] interface IDeckLinkEncoderVideoPacket : IDeckLinkEncoderPacket
{
@ -852,7 +997,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(49E8EDC8-693B-4E14-8EF6-12C658F5A07A),
local,
local,
helpstring("Provided by the IDeckLinkEncoderInput audio packet arrival callback.")
] interface IDeckLinkEncoderAudioPacket : IDeckLinkEncoderPacket
{
@ -864,7 +1009,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(639C8E0B-68D5-4BDE-A6D4-95F3AEAFF2E7),
local,
local,
helpstring("Obtained through QueryInterface() on an IDeckLinkEncoderVideoPacket object")
] interface IDeckLinkH265NALPacket : IDeckLinkEncoderVideoPacket
{
@ -878,7 +1023,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(E43D5870-2894-11DE-8C30-0800200C9A66),
local,
local,
helpstring("Provided by the IDeckLinkInput callback.")
] interface IDeckLinkAudioInputPacket : IUnknown
{
@ -892,7 +1037,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(B1D3F49A-85FE-4C5D-95C8-0B5D5DCCD438),
local,
local,
helpstring("Screen preview callback")
] interface IDeckLinkScreenPreviewCallback : IUnknown
{
@ -904,7 +1049,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(504E2209-CAC7-4C1A-9FB4-C5BB6274D22F),
local,
local,
helpstring("Created with CoCreateInstance().")
] interface IDeckLinkGLScreenPreviewHelper : IUnknown
{
@ -922,7 +1067,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(2094B522-D1A1-40C0-9AC7-1C012218EF02),
local,
local,
helpstring("Created with CoCreateInstance().")
] interface IDeckLinkDX9ScreenPreviewHelper : IUnknown
{
@ -937,7 +1082,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(b002a1ec-070d-4288-8289-bd5d36e5ff0d),
local,
local,
helpstring("DeckLink Notification Callback Interface")
] interface IDeckLinkNotificationCallback : IUnknown
{
@ -949,7 +1094,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(0a1fb207-e215-441b-9b19-6fa1575946c5),
local,
local,
helpstring("DeckLink Notification interface")
] interface IDeckLinkNotification : IUnknown
{
@ -962,7 +1107,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(ABC11843-D966-44CB-96E2-A1CB5D3135C4),
local,
local,
helpstring("DeckLink Attribute interface")
] interface IDeckLinkAttributes : IUnknown
{
@ -977,7 +1122,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(5F558200-4028-49BC-BEAC-DB3FA4A96E46),
local,
local,
helpstring("DeckLink Status interface")
] interface IDeckLinkStatus : IUnknown
{
@ -993,7 +1138,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(89AFCAF5-65F8-421E-98F7-96FE5F5BFBA3),
local,
local,
helpstring("DeckLink Keyer interface")
] interface IDeckLinkKeyer : IUnknown
{
@ -1009,7 +1154,7 @@ interface IDeckLinkDiscovery;
[
object,
uuid(3BBCB8A2-DA2C-42D9-B5D8-88083644E99A),
local,
local,
helpstring("Created with CoCreateInstance().")
] interface IDeckLinkVideoConversion : IUnknown
{
@ -1045,7 +1190,7 @@ interface IDeckLinkDiscovery;
importlib("stdole2.tlb");
[
uuid(1F2E109A-8F4F-49E4-9203-135595CB6FA5),
uuid(87D2693F-8D4A-45C7-B43F-10ACBA25E68F),
helpstring("CDeckLinkIterator Class")
] coclass CDeckLinkIterator
{
@ -1085,15 +1230,26 @@ importlib("stdole2.tlb");
};
[
uuid(1073A05C-D885-47E9-B3C6-129B3F9F648B),
uuid(652615D4-26CD-4514-B161-2FD5072ED008),
helpstring("CDeckLinkDiscovery Class")
] coclass CDeckLinkDiscovery
{
[default] interface IDeckLinkDiscovery;
};
[
uuid(F891AD29-D0C2-46E9-A926-4E2D0DD8CFAD),
helpstring("CDeckLinkVideoFrameAncillaryPackets Class")
] coclass CDeckLinkVideoFrameAncillaryPackets
{
[default] interface IDeckLinkVideoFrameAncillaryPackets;
};
// import deprecated interfaces
#include "DeckLinkAPI_v10_9.idl"
#include "DeckLinkAPIStreaming_v10_8.idl"
#include "DeckLinkAPI_v10_8.idl"
#include "DeckLinkAPI_v10_6.idl"
#include "DeckLinkAPI_v10_5.idl"
#include "DeckLinkAPI_v10_4.idl"