objc2-core-media 0.3.2

//! This file has been automatically generated by `objc2`'s `header-translator`.
//! DO NOT EDIT
use core::ptr::NonNull;
use objc2_core_foundation::*;

use crate::*;

/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmformatdescriptionbridgeerror_invalidparameter?language=objc)
pub const kCMFormatDescriptionBridgeError_InvalidParameter: OSStatus = -12712;
/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmformatdescriptionbridgeerror_allocationfailed?language=objc)
pub const kCMFormatDescriptionBridgeError_AllocationFailed: OSStatus = -12713;
/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmformatdescriptionbridgeerror_invalidserializedsampledescription?language=objc)
pub const kCMFormatDescriptionBridgeError_InvalidSerializedSampleDescription: OSStatus = -12714;
/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmformatdescriptionbridgeerror_invalidformatdescription?language=objc)
pub const kCMFormatDescriptionBridgeError_InvalidFormatDescription: OSStatus = -12715;
/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmformatdescriptionbridgeerror_incompatibleformatdescription?language=objc)
pub const kCMFormatDescriptionBridgeError_IncompatibleFormatDescription: OSStatus = -12716;
/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmformatdescriptionbridgeerror_unsupportedsampledescriptionflavor?language=objc)
pub const kCMFormatDescriptionBridgeError_UnsupportedSampleDescriptionFlavor: OSStatus = -12717;
/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmformatdescriptionbridgeerror_invalidslice?language=objc)
pub const kCMFormatDescriptionBridgeError_InvalidSlice: OSStatus = -12719;

/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/cmimagedescriptionflavor?language=objc)
// NS_TYPED_EXTENSIBLE_ENUM
pub type CMImageDescriptionFlavor = CFString;

extern "C" {
    /// Chooses the QuickTime Movie Image Description format.
    ///
    /// Passing NULL is equivalent to passing this constant.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmimagedescriptionflavor_quicktimemovie?language=objc)
    pub static kCMImageDescriptionFlavor_QuickTimeMovie: &'static CMImageDescriptionFlavor;
}

extern "C" {
    /// Chooses the ISO family sample description format, used in MP4
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmimagedescriptionflavor_isofamily?language=objc)
    pub static kCMImageDescriptionFlavor_ISOFamily: &'static CMImageDescriptionFlavor;
}

extern "C" {
    /// Chooses the 3GP family sample description format.
    ///
    /// This implies kCMImageDescriptionFlavor_ISOFamily and adds additional rules specific to the 3GP family.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmimagedescriptionflavor_3gpfamily?language=objc)
    pub static kCMImageDescriptionFlavor_3GPFamily: &'static CMImageDescriptionFlavor;
}

extern "C" {
    /// Chooses the ISO family sample description format with use of Apple extensions where appropriate for M4V and M4A.
    ///
    /// This implies kCMImageDescriptionFlavor_ISOFamily and adds additional rules specific to the .m4a, .m4b, and .m4v file formats.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmimagedescriptionflavor_isofamilywithappleextensions?language=objc)
    pub static kCMImageDescriptionFlavor_ISOFamilyWithAppleExtensions:
        &'static CMImageDescriptionFlavor;
}

extern "C-unwind" {
    /// Creates a CMVideoFormatDescription from a big-endian ImageDescription data structure.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMVideoFormatDescription object. May be NULL.
    ///
    /// Parameter `imageDescriptionData`: ImageDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `size`: Size of ImageDescription data structure.
    ///
    /// Parameter `stringEncoding`: Pass CFStringGetSystemEncoding() or GetApplicationTextEncoding().
    ///
    /// Parameter `flavor`: kCMImageDescriptionFlavor constant or NULL for QuickTimeMovie flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMVideoFormatDescription.
    ///
    /// # Safety
    ///
    /// - `image_description_data` must be a valid pointer.
    /// - `format_description_out` must be a valid pointer.
    #[cfg(feature = "CMFormatDescription")]
    pub fn CMVideoFormatDescriptionCreateFromBigEndianImageDescriptionData(
        allocator: Option<&CFAllocator>,
        image_description_data: NonNull<u8>,
        size: usize,
        string_encoding: CFStringEncoding,
        flavor: Option<&CMImageDescriptionFlavor>,
        format_description_out: NonNull<*const CMVideoFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Creates a CMVideoFormatDescription from a big-endian ImageDescription data structure in a CMBlockBuffer.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMVideoFormatDescription object. May be NULL.
    ///
    /// Parameter `imageDescriptionBlockBuffer`: CMBlockBuffer containing ImageDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `stringEncoding`: Pass CFStringGetSystemEncoding() or GetApplicationTextEncoding().
    ///
    /// Parameter `flavor`: kCMImageDescriptionFlavor constant or NULL for QuickTimeMovie flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMVideoFormatDescription.
    ///
    /// # Safety
    ///
    /// `format_description_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMVideoFormatDescriptionCreateFromBigEndianImageDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        image_description_block_buffer: &CMBlockBuffer,
        string_encoding: CFStringEncoding,
        flavor: Option<&CMImageDescriptionFlavor>,
        format_description_out: NonNull<*const CMVideoFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Copies the contents of a CMVideoFormatDescription to a CMBlockBuffer in big-endian byte ordering.
    ///
    /// On return, the caller owns the returned CMBlockBuffer, and must release it when done with it.
    /// Note that the dataRefIndex field of the SampleDescription is intentionally filled with
    /// garbage values (0xFFFF).  The caller must overwrite these values with a valid dataRefIndex
    /// if writing the SampleDescription to a QuickTime/ISO file.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMBlockBuffer object. May be NULL.
    ///
    /// Parameter `videoFormatDescription`: CMVideoFormatDescription to be copied.
    ///
    /// Parameter `stringEncoding`: Pass CFStringGetSystemEncoding() or GetApplicationTextEncoding().
    ///
    /// Parameter `flavor`: kCMImageDescriptionFlavor constant or NULL for QuickTimeMovie flavor.
    ///
    /// Parameter `blockBufferOut`: Receives new CMBlockBuffer containing ImageDescription data structure in big-endian byte ordering.
    ///
    /// # Safety
    ///
    /// `block_buffer_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMVideoFormatDescriptionCopyAsBigEndianImageDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        video_format_description: &CMVideoFormatDescription,
        string_encoding: CFStringEncoding,
        flavor: Option<&CMImageDescriptionFlavor>,
        block_buffer_out: NonNull<*mut CMBlockBuffer>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts an ImageDescription data structure from big-endian to host-endian in place.
    ///
    ///
    /// Parameter `imageDescriptionData`: ImageDescription data structure in big-endian byte ordering to be converted to host-endian byte ordering.
    ///
    /// Parameter `imageDescriptionSize`: Size of ImageDescription data structure.
    ///
    /// # Safety
    ///
    /// `image_description_data` must be a valid pointer.
    pub fn CMSwapBigEndianImageDescriptionToHost(
        image_description_data: NonNull<u8>,
        image_description_size: usize,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts an ImageDescription data structure from host-endian to big-endian in place.
    ///
    ///
    /// Parameter `imageDescriptionData`: ImageDescription data structure in host-endian byte ordering to be converted to big-endian byte ordering.
    ///
    /// Parameter `imageDescriptionSize`: Size of ImageDescription data structure.
    ///
    /// # Safety
    ///
    /// `image_description_data` must be a valid pointer.
    pub fn CMSwapHostEndianImageDescriptionToBig(
        image_description_data: NonNull<u8>,
        image_description_size: usize,
    ) -> OSStatus;
}

/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/cmsounddescriptionflavor?language=objc)
// NS_TYPED_EXTENSIBLE_ENUM
pub type CMSoundDescriptionFlavor = CFString;

extern "C" {
    /// Chooses the most backwards-compatible QuickTime Movie Sound Description format.
    ///
    /// A V1 sound description will be written if possible.
    /// If a V1 sound description is written for CBR or PCM audio, the sample tables will need to use the legacy CBR layout.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmsounddescriptionflavor_quicktimemovie?language=objc)
    pub static kCMSoundDescriptionFlavor_QuickTimeMovie: &'static CMSoundDescriptionFlavor;
}

extern "C" {
    /// Chooses the QuickTime Movie Sound Description V2 format.
    ///
    /// A V2 sound description will be written.
    /// V2 Sound Descriptions contain no legacy CBR layout, and use 'lpcm' for all flavors of PCM.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmsounddescriptionflavor_quicktimemoviev2?language=objc)
    pub static kCMSoundDescriptionFlavor_QuickTimeMovieV2: &'static CMSoundDescriptionFlavor;
}

extern "C" {
    /// Chooses the ISO family sample description format, used in MP4, M4A, etc.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmsounddescriptionflavor_isofamily?language=objc)
    pub static kCMSoundDescriptionFlavor_ISOFamily: &'static CMSoundDescriptionFlavor;
}

extern "C" {
    /// Chooses the 3GP family sample description format.
    ///
    /// This implies kCMSoundDescriptionFlavor_ISOFamily and adds additional rules specific to the 3GP family.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/coremedia/kcmsounddescriptionflavor_3gpfamily?language=objc)
    pub static kCMSoundDescriptionFlavor_3GPFamily: &'static CMSoundDescriptionFlavor;
}

extern "C-unwind" {
    /// Creates a CMAudioFormatDescription from a big-endian SoundDescription data structure.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMAudioFormatDescription object. May be NULL.
    ///
    /// Parameter `soundDescriptionData`: SoundDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `size`: Size of SoundDescription data structure.
    ///
    /// Parameter `flavor`: kCMSoundDescriptionFlavor constant or NULL for QuickTimeMovie flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMAudioFormatDescription.
    ///
    /// # Safety
    ///
    /// - `sound_description_data` must be a valid pointer.
    /// - `format_description_out` must be a valid pointer.
    #[cfg(feature = "CMFormatDescription")]
    pub fn CMAudioFormatDescriptionCreateFromBigEndianSoundDescriptionData(
        allocator: Option<&CFAllocator>,
        sound_description_data: NonNull<u8>,
        size: usize,
        flavor: Option<&CMSoundDescriptionFlavor>,
        format_description_out: NonNull<*const CMAudioFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Creates a CMAudioFormatDescription from a big-endian SoundDescription data structure in a CMBlockBuffer.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMAudioFormatDescription object. May be NULL.
    ///
    /// Parameter `soundDescriptionBlockBuffer`: CMBlockBuffer containing SoundDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `flavor`: kCMSoundDescriptionFlavor constant or NULL for QuickTimeMovie flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMAudioFormatDescription.
    ///
    /// # Safety
    ///
    /// `format_description_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMAudioFormatDescriptionCreateFromBigEndianSoundDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        sound_description_block_buffer: &CMBlockBuffer,
        flavor: Option<&CMSoundDescriptionFlavor>,
        format_description_out: NonNull<*const CMAudioFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Copies the contents of a CMAudioFormatDescription to a CMBlockBuffer in big-endian byte ordering.
    ///
    /// On return, the caller owns the returned CMBlockBuffer, and must release it when done with it.
    /// Note that the dataRefIndex field of the SampleDescription is intentionally filled with
    /// garbage values (0xFFFF).  The caller must overwrite these values with a valid dataRefIndex
    /// if writing the SampleDescription to a QuickTime/ISO file.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMBlockBuffer object. May be NULL.
    ///
    /// Parameter `audioFormatDescription`: CMAudioFormatDescription to be copied.
    ///
    /// Parameter `flavor`: kCMSoundDescriptionFlavor constant or NULL for QuickTimeMovie flavor.
    ///
    /// Parameter `blockBufferOut`: Receives new CMBlockBuffer containing SoundDescription data structure in big-endian byte ordering.
    ///
    /// # Safety
    ///
    /// `block_buffer_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMAudioFormatDescriptionCopyAsBigEndianSoundDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        audio_format_description: &CMAudioFormatDescription,
        flavor: Option<&CMSoundDescriptionFlavor>,
        block_buffer_out: NonNull<*mut CMBlockBuffer>,
    ) -> OSStatus;
}

/// Examine a big-endian SoundDescription data structure in a CMBlockBuffer, and report whether the sample tables will need to use the legacy CBR layout.
///
///
/// Parameter `soundDescriptionBlockBuffer`: CMBlockBuffer containing SoundDescription data structure in big-endian byte ordering.
///
/// Parameter `flavor`: kCMSoundDescriptionFlavor constant or NULL for QuickTimeMovie flavor.
#[cfg(feature = "CMBlockBuffer")]
#[inline]
pub unsafe extern "C-unwind" fn CMDoesBigEndianSoundDescriptionRequireLegacyCBRSampleTableLayout(
    sound_description_block_buffer: &CMBlockBuffer,
    flavor: Option<&CMSoundDescriptionFlavor>,
) -> bool {
    extern "C-unwind" {
        fn CMDoesBigEndianSoundDescriptionRequireLegacyCBRSampleTableLayout(
            sound_description_block_buffer: &CMBlockBuffer,
            flavor: Option<&CMSoundDescriptionFlavor>,
        ) -> Boolean;
    }
    let ret = unsafe {
        CMDoesBigEndianSoundDescriptionRequireLegacyCBRSampleTableLayout(
            sound_description_block_buffer,
            flavor,
        )
    };
    ret != 0
}

extern "C-unwind" {
    /// Converts a SoundDescription data structure from big-endian to host-endian in place.
    ///
    ///
    /// Parameter `soundDescriptionData`: SoundDescription data structure in big-endian byte ordering to be converted to host-endian byte ordering.
    ///
    /// Parameter `soundDescriptionSize`: Size of SoundDescription data structure.
    ///
    /// # Safety
    ///
    /// `sound_description_data` must be a valid pointer.
    pub fn CMSwapBigEndianSoundDescriptionToHost(
        sound_description_data: NonNull<u8>,
        sound_description_size: usize,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a SoundDescription data structure from host-endian to big-endian in place.
    ///
    ///
    /// Parameter `soundDescriptionData`: SoundDescription data structure in host-endian byte ordering to be converted to big-endian byte ordering.
    ///
    /// Parameter `soundDescriptionSize`: Size of SoundDescription data structure.
    ///
    /// # Safety
    ///
    /// `sound_description_data` must be a valid pointer.
    pub fn CMSwapHostEndianSoundDescriptionToBig(
        sound_description_data: NonNull<u8>,
        sound_description_size: usize,
    ) -> OSStatus;
}

/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/cmtextdescriptionflavor?language=objc)
// NS_TYPED_EXTENSIBLE_ENUM
pub type CMTextDescriptionFlavor = CFString;

extern "C-unwind" {
    /// Creates a CMTextFormatDescription from a big-endian TextDescription data structure.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMTextFormatDescription object. May be NULL.
    ///
    /// Parameter `textDescriptionData`: TextDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `size`: Size of TextDescription data structure.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `mediaType`: Pass kCMMediaType_Text or kCMMediaType_Subtitle.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMTextFormatDescription.
    ///
    /// # Safety
    ///
    /// - `text_description_data` must be a valid pointer.
    /// - `format_description_out` must be a valid pointer.
    #[cfg(feature = "CMFormatDescription")]
    pub fn CMTextFormatDescriptionCreateFromBigEndianTextDescriptionData(
        allocator: Option<&CFAllocator>,
        text_description_data: NonNull<u8>,
        size: usize,
        flavor: Option<&CMTextDescriptionFlavor>,
        media_type: CMMediaType,
        format_description_out: NonNull<*const CMTextFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Creates a CMTextFormatDescription from a big-endian TextDescription data structure in a CMBlockBuffer.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMTextFormatDescription object. May be NULL.
    ///
    /// Parameter `textDescriptionBlockBuffer`: CMBlockBuffer containing TextDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `mediaType`: Pass kCMMediaType_Text or kCMMediaType_Subtitle.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMTextFormatDescription.
    ///
    /// # Safety
    ///
    /// `format_description_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMTextFormatDescriptionCreateFromBigEndianTextDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        text_description_block_buffer: &CMBlockBuffer,
        flavor: Option<&CMTextDescriptionFlavor>,
        media_type: CMMediaType,
        format_description_out: NonNull<*const CMTextFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Copies the contents of a CMTextFormatDescription to a CMBlockBuffer in big-endian byte ordering.
    ///
    /// On return, the caller owns the returned CMBlockBuffer, and must release it when done with it.
    /// Note that the dataRefIndex field of the SampleDescription is intentionally filled with
    /// garbage values (0xFFFF).  The caller must overwrite these values with a valid dataRefIndex
    /// if writing the SampleDescription to a QuickTime/ISO file.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMBlockBuffer object. May be NULL.
    ///
    /// Parameter `textFormatDescription`: CMTextFormatDescription to be copied.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `blockBufferOut`: Receives new CMBlockBuffer containing TextDescription data structure in big-endian byte ordering.
    ///
    /// # Safety
    ///
    /// `block_buffer_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMTextFormatDescriptionCopyAsBigEndianTextDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        text_format_description: &CMTextFormatDescription,
        flavor: Option<&CMTextDescriptionFlavor>,
        block_buffer_out: NonNull<*mut CMBlockBuffer>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a TextDescription data structure from big-endian to host-endian in place.
    ///
    ///
    /// Parameter `textDescriptionData`: TextDescription data structure in big-endian byte ordering to be converted to host-endian byte ordering.
    ///
    /// Parameter `textDescriptionSize`: Size of TextDescription data structure.
    ///
    /// # Safety
    ///
    /// `text_description_data` must be a valid pointer.
    pub fn CMSwapBigEndianTextDescriptionToHost(
        text_description_data: NonNull<u8>,
        text_description_size: usize,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a TextDescription data structure from host-endian to big-endian in place.
    ///
    ///
    /// Parameter `textDescriptionData`: TextDescription data structure in host-endian byte ordering to be converted to big-endian byte ordering.
    ///
    /// Parameter `textDescriptionSize`: Size of TextDescription data structure.
    ///
    /// # Safety
    ///
    /// `text_description_data` must be a valid pointer.
    pub fn CMSwapHostEndianTextDescriptionToBig(
        text_description_data: NonNull<u8>,
        text_description_size: usize,
    ) -> OSStatus;
}

/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/cmclosedcaptiondescriptionflavor?language=objc)
// NS_TYPED_EXTENSIBLE_ENUM
pub type CMClosedCaptionDescriptionFlavor = CFString;

extern "C-unwind" {
    /// Creates a CMClosedCaptionFormatDescription from a big-endian ClosedCaptionDescription data structure.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMClosedCaptionFormatDescription object. May be NULL.
    ///
    /// Parameter `closedCaptionDescriptionData`: ClosedCaptionDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `size`: Size of ClosedCaptionDescription data structure.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMClosedCaptionFormatDescription.
    ///
    /// # Safety
    ///
    /// - `closed_caption_description_data` must be a valid pointer.
    /// - `format_description_out` must be a valid pointer.
    #[cfg(feature = "CMFormatDescription")]
    pub fn CMClosedCaptionFormatDescriptionCreateFromBigEndianClosedCaptionDescriptionData(
        allocator: Option<&CFAllocator>,
        closed_caption_description_data: NonNull<u8>,
        size: usize,
        flavor: Option<&CMClosedCaptionDescriptionFlavor>,
        format_description_out: NonNull<*const CMClosedCaptionFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Creates a CMClosedCaptionFormatDescription from a big-endian ClosedCaptionDescription data structure in a CMBlockBuffer.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMClosedCaptionFormatDescription object. May be NULL.
    ///
    /// Parameter `closedCaptionDescriptionBlockBuffer`: CMBlockBuffer containing ClosedCaptionDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMClosedCaptionFormatDescription.
    ///
    /// # Safety
    ///
    /// `format_description_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMClosedCaptionFormatDescriptionCreateFromBigEndianClosedCaptionDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        closed_caption_description_block_buffer: &CMBlockBuffer,
        flavor: Option<&CMClosedCaptionDescriptionFlavor>,
        format_description_out: NonNull<*const CMClosedCaptionFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Copies the contents of a CMClosedCaptionFormatDescription to a CMBlockBuffer in big-endian byte ordering.
    ///
    /// On return, the caller owns the returned CMBlockBuffer, and must release it when done with it.
    /// Note that the dataRefIndex field of the SampleDescription is intentionally filled with
    /// garbage values (0xFFFF).  The caller must overwrite these values with a valid dataRefIndex
    /// if writing the SampleDescription to a QuickTime/ISO file.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMBlockBuffer object. May be NULL.
    ///
    /// Parameter `closedCaptionFormatDescription`: CMClosedCaptionFormatDescription to be copied.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `blockBufferOut`: Receives new CMBlockBuffer containing ClosedCaptionDescription data structure in big-endian byte ordering.
    ///
    /// # Safety
    ///
    /// `block_buffer_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMClosedCaptionFormatDescriptionCopyAsBigEndianClosedCaptionDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        closed_caption_format_description: &CMClosedCaptionFormatDescription,
        flavor: Option<&CMClosedCaptionDescriptionFlavor>,
        block_buffer_out: NonNull<*mut CMBlockBuffer>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a ClosedCaptionDescription data structure from big-endian to host-endian in place.
    ///
    ///
    /// Parameter `closedCaptionDescriptionData`: ClosedCaptionDescription data structure in big-endian byte ordering to be converted to host-endian byte ordering.
    ///
    /// Parameter `closedCaptionDescriptionSize`: Size of ClosedCaptionDescription data structure.
    ///
    /// # Safety
    ///
    /// `closed_caption_description_data` must be a valid pointer.
    pub fn CMSwapBigEndianClosedCaptionDescriptionToHost(
        closed_caption_description_data: NonNull<u8>,
        closed_caption_description_size: usize,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a ClosedCaptionDescription data structure from host-endian to big-endian in place.
    ///
    ///
    /// Parameter `closedCaptionDescriptionData`: ClosedCaptionDescription data structure in host-endian byte ordering to be converted to big-endian byte ordering.
    ///
    /// Parameter `closedCaptionDescriptionSize`: Size of ClosedCaptionDescription data structure.
    ///
    /// # Safety
    ///
    /// `closed_caption_description_data` must be a valid pointer.
    pub fn CMSwapHostEndianClosedCaptionDescriptionToBig(
        closed_caption_description_data: NonNull<u8>,
        closed_caption_description_size: usize,
    ) -> OSStatus;
}

/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/cmtimecodedescriptionflavor?language=objc)
// NS_TYPED_EXTENSIBLE_ENUM
pub type CMTimeCodeDescriptionFlavor = CFString;

extern "C-unwind" {
    /// Creates a CMTimeCodeFormatDescription from a big-endian TimeCodeDescription data structure.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMTimeCodeFormatDescription object. May be NULL.
    ///
    /// Parameter `timeCodeDescriptionData`: TimeCodeDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `size`: Size of TimeCodeDescription data structure.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMTimeCodeFormatDescription.
    ///
    /// # Safety
    ///
    /// - `time_code_description_data` must be a valid pointer.
    /// - `format_description_out` must be a valid pointer.
    #[cfg(feature = "CMFormatDescription")]
    pub fn CMTimeCodeFormatDescriptionCreateFromBigEndianTimeCodeDescriptionData(
        allocator: Option<&CFAllocator>,
        time_code_description_data: NonNull<u8>,
        size: usize,
        flavor: Option<&CMTimeCodeDescriptionFlavor>,
        format_description_out: NonNull<*const CMTimeCodeFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Creates a CMTimeCodeFormatDescription from a big-endian TimeCodeDescription data structure in a CMBlockBuffer.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMTimeCodeFormatDescription object. May be NULL.
    ///
    /// Parameter `timeCodeDescriptionBlockBuffer`: CMBlockBuffer containing TimeCodeDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMTimeCodeFormatDescription.
    ///
    /// # Safety
    ///
    /// `format_description_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMTimeCodeFormatDescriptionCreateFromBigEndianTimeCodeDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        time_code_description_block_buffer: &CMBlockBuffer,
        flavor: Option<&CMTimeCodeDescriptionFlavor>,
        format_description_out: NonNull<*const CMTimeCodeFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Copies the contents of a CMTimeCodeFormatDescription to a CMBlockBuffer in big-endian byte ordering.
    ///
    /// On return, the caller owns the returned CMBlockBuffer, and must release it when done with it.
    /// Note that the dataRefIndex field of the SampleDescription is intentionally filled with
    /// garbage values (0xFFFF).  The caller must overwrite these values with a valid dataRefIndex
    /// if writing the SampleDescription to a QuickTime/ISO file.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMBlockBuffer object. May be NULL.
    ///
    /// Parameter `timeCodeFormatDescription`: CMTimeCodeFormatDescription to be copied.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `blockBufferOut`: Receives new CMBlockBuffer containing TimeCodeDescription data structure in big-endian byte ordering.
    ///
    /// # Safety
    ///
    /// `block_buffer_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMTimeCodeFormatDescriptionCopyAsBigEndianTimeCodeDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        time_code_format_description: &CMTimeCodeFormatDescription,
        flavor: Option<&CMTimeCodeDescriptionFlavor>,
        block_buffer_out: NonNull<*mut CMBlockBuffer>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a TimeCodeDescription data structure from big-endian to host-endian in place.
    ///
    ///
    /// Parameter `timeCodeDescriptionData`: TimeCodeDescription data structure in big-endian byte ordering to be converted to host-endian byte ordering.
    ///
    /// Parameter `timeCodeDescriptionSize`: Size of TimeCodeDescription data structure.
    ///
    /// # Safety
    ///
    /// `time_code_description_data` must be a valid pointer.
    pub fn CMSwapBigEndianTimeCodeDescriptionToHost(
        time_code_description_data: NonNull<u8>,
        time_code_description_size: usize,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a TimeCodeDescription data structure from host-endian to big-endian in place.
    ///
    ///
    /// Parameter `timeCodeDescriptionData`: TimeCodeDescription data structure in host-endian byte ordering to be converted to big-endian byte ordering.
    ///
    /// Parameter `timeCodeDescriptionSize`: Size of TimeCodeDescription data structure.
    ///
    /// # Safety
    ///
    /// `time_code_description_data` must be a valid pointer.
    pub fn CMSwapHostEndianTimeCodeDescriptionToBig(
        time_code_description_data: NonNull<u8>,
        time_code_description_size: usize,
    ) -> OSStatus;
}

/// [Apple's documentation](https://developer.apple.com/documentation/coremedia/cmmetadatadescriptionflavor?language=objc)
// NS_TYPED_EXTENSIBLE_ENUM
pub type CMMetadataDescriptionFlavor = CFString;

extern "C-unwind" {
    /// Creates a CMMetadataFormatDescription from a big-endian MetadataDescription data structure.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMMetadataFormatDescription object. May be NULL.
    ///
    /// Parameter `metadataDescriptionData`: MetadataDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `size`: Size of MetadataDescription data structure.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMMetadataFormatDescriptionRef.
    ///
    /// # Safety
    ///
    /// - `metadata_description_data` must be a valid pointer.
    /// - `format_description_out` must be a valid pointer.
    #[cfg(feature = "CMFormatDescription")]
    pub fn CMMetadataFormatDescriptionCreateFromBigEndianMetadataDescriptionData(
        allocator: Option<&CFAllocator>,
        metadata_description_data: NonNull<u8>,
        size: usize,
        flavor: Option<&CMMetadataDescriptionFlavor>,
        format_description_out: NonNull<*const CMMetadataFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Creates a CMMetadataFormatDescription from a big-endian MetadataDescription data structure in a CMBlockBuffer.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMMetadataFormatDescription object. May be NULL.
    ///
    /// Parameter `metadataDescriptionBlockBuffer`: CMBlockBuffer containing MetadataDescription data structure in big-endian byte ordering.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `formatDescriptionOut`: Receives new CMMetadataFormatDescriptionRef.
    ///
    /// # Safety
    ///
    /// `format_description_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMMetadataFormatDescriptionCreateFromBigEndianMetadataDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        metadata_description_block_buffer: &CMBlockBuffer,
        flavor: Option<&CMMetadataDescriptionFlavor>,
        format_description_out: NonNull<*const CMMetadataFormatDescription>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Copies the contents of a CMMetadataFormatDescription to a CMBlockBuffer in big-endian byte ordering.
    ///
    /// On return, the caller owns the returned CMBlockBuffer, and must release it when done with it.
    /// Note that the dataRefIndex field of the SampleDescription is intentionally filled with
    /// garbage values (0xFFFF).  The caller must overwrite these values with a valid dataRefIndex
    /// if writing the SampleDescription to a QuickTime/ISO file.
    ///
    ///
    /// Parameter `allocator`: Allocator to use for allocating the CMBlockBuffer object. May be NULL.
    ///
    /// Parameter `metadataFormatDescription`: CMMetadataFormatDescriptionRef to be copied.
    ///
    /// Parameter `flavor`: Reserved for future use. Pass NULL for QuickTime Movie or ISO flavor.
    ///
    /// Parameter `blockBufferOut`: Receives new CMBlockBuffer containing MetadataDescription data structure in big-endian byte ordering.
    ///
    /// # Safety
    ///
    /// `block_buffer_out` must be a valid pointer.
    #[cfg(all(feature = "CMBlockBuffer", feature = "CMFormatDescription"))]
    pub fn CMMetadataFormatDescriptionCopyAsBigEndianMetadataDescriptionBlockBuffer(
        allocator: Option<&CFAllocator>,
        metadata_format_description: &CMMetadataFormatDescription,
        flavor: Option<&CMMetadataDescriptionFlavor>,
        block_buffer_out: NonNull<*mut CMBlockBuffer>,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a MetadataDescription data structure from big-endian to host-endian in place.
    ///
    ///
    /// Parameter `metadataDescriptionData`: MetadataDescription data structure in big-endian byte ordering to be converted to host-endian byte ordering.
    ///
    /// Parameter `metadataDescriptionSize`: Size of MetadataDescription data structure.
    ///
    /// # Safety
    ///
    /// `metadata_description_data` must be a valid pointer.
    pub fn CMSwapBigEndianMetadataDescriptionToHost(
        metadata_description_data: NonNull<u8>,
        metadata_description_size: usize,
    ) -> OSStatus;
}

extern "C-unwind" {
    /// Converts a MetadataDescription data structure from host-endian to big-endian in place.
    ///
    ///
    /// Parameter `metadataDescriptionData`: MetadataDescription data structure in host-endian byte ordering to be converted to big-endian byte ordering.
    ///
    /// Parameter `metadataDescriptionSize`: Size of MetadataDescription data structure.
    ///
    /// # Safety
    ///
    /// `metadata_description_data` must be a valid pointer.
    pub fn CMSwapHostEndianMetadataDescriptionToBig(
        metadata_description_data: NonNull<u8>,
        metadata_description_size: usize,
    ) -> OSStatus;
}