• Products
  • Resellers
  • Support
  • Developer
  • Company
  • Media
  • Splice
  • Forum
Blackmagic Design logo
  • Back to Developer Page

Quick Search

Table of Contents

  • 1 Desktop Video SDK
  • 2 DeckLink API
    • 2.1 Using the DeckLink API in a project
    • 2.2 Sandboxing support on macOS
    • 2.3 Accessing DeckLink devices
    • 2.4 High level interface
      • 2.4.1 Capture
      • 2.4.2 Playback
      • 2.4.3 3D Functionality
      • 2.4.4 DeckLink Device Notification
      • 2.4.5 Streaming Encoder
      • 2.4.6 Automatic Mode Detection
      • 2.4.7 Ancillary Data functionality
      • 2.4.8 Keying
      • 2.4.9 Timecode/Timecode user bits
      • 2.4.10 H.265 Capture
      • 2.4.11 Device Profiles
      • 2.4.12 HDR Functionality
      • 2.4.13 Synchronized Capture/Playback
      • 2.4.14 Video Frame Conversion
      • 2.4.15 SMPTE 2110 IP Flows
    • 2.5 Interface Reference
    • 2.6 Streaming Interface Reference
  • 3 Common Data Types
  • Docs »
  • 2 DeckLink API »
  • 2.4 High level interface »
  • 2.4.4 DeckLink Device Notification
  • ← 2.4.3 3D Functionality
  • 2.4.5 Streaming Encoder →

2.4.4 DeckLink Device Notification¶

A callback notification can be provided to an application when a Thunderbolt or USB 3.0 based DeckLink device is connected or disconnected.

An application that supports connection notification should perform the following steps:

  • Create a callback class that subclasses IDeckLinkDeviceNotificationCallback and implements all of its methods. The callback class will be called asynchronously from an API private thread. Create an instance of the callback class.

  • Call IDeckLinkDiscovery::InstallDeviceNotifications() and provide the IDeckLinkDeviceNotificationCallback object.

  • IDeckLinkDeviceNotificationCallback::DeckLinkDeviceArrived() is called for all currently connected devices.

  • When a DeckLink device is connected after the initial reporting of devices then IDeckLinkDeviceNotificationCallback::DeckLinkDeviceArrived() will be called.

  • When a DeckLink device is removed, IDeckLinkDeviceNotificationCallback::DeckLinkDeviceRemoved() is called on an API-private thread.

  • Before the application exits, call IDeckLinkDiscovery::UninstallDeviceNotifications().

  • ← 2.4.3 3D Functionality
  • 2.4.5 Streaming Encoder →
Desktop Video 15.0 SDK
© Copyright 2003-2025 Blackmagic Design. All rights reserved.