ADC Home > Reference Library > Reference > QuickTime > Cocoa > QTKit Constants Reference >

Next Page > Hide TOC

QTKit Constants Reference

Framework
QTKit/QTKit.h
Declared in
QTError.h

Overview

This document defines constants in the QTKit framework that are not associated with a particular class.

Constants

QTKit Error Domain

The QTKit error domain identifier, and keys for extracting specific values from the userInfo dictionary of an error returned by QTKit.

NSString * const QTKitErrorDomain;
NSString * const QTErrorCaptureInputKey;
NSString * const QTErrorCaptureOutputKey;
NSString * const QTErrorDeviceKey;
NSString * const QTErrorExcludingDeviceKey;
NSString * const QTErrorRecordingSuccesfullyFinishedKey;

Constants
QTKitErrorDomain

The QTKit error domain identifier.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorCaptureInputKey

Use this key to retrieve the QTCaptureInput object for which the error occurred.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorCaptureOutputKey

Use this key to retrieve the QTCaptureOutput object for which the error occurred.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorDeviceKey

Use this key to retrieve the QTCaptureDevice object for which the error occurred.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorExcludingDeviceKey

Use this key to retrieve the QTCaptureDevice object for the device whose presence is excluding the device for which the error occurred.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorRecordingSuccesfullyFinishedKey

Use this key to determine whether the products of a recording were successfully finished after recording stopped due to an error. The value is an NSNumber interpreted as a BOOL.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTKit Error Codes

Error codes returned within QTKitErrorDomain. 

   
enum {
   QTErrorUnknown                                  = -1,
   QTErrorIncompatibleInput                        = 1002,
   QTErrorIncompatibleOutput                       = 1003,
   QTErrorInvalidInputsOrOutputs                   = 1100,
   QTErrorDeviceAlreadyUsedbyAnotherSession        = 1101,
   QTErrorNoDataCaptured                           = 1200,
   QTErrorSessionConfigurationChanged              = 1201,
   QTErrorDiskFull                                 = 1202,
   QTErrorDeviceWasDisconnected                    = 1203,
   QTErrorMediaChanged                             = 1204,
   QTErrorMaximumDurationReached                   = 1205,
   QTErrorMaximumFileSizeReached                   = 1206,
   QTErrorMediaDiscontinuity                       = 1207,
   QTErrorDeviceNotConnected                       = 1300,
   QTErrorDeviceInUseByAnotherApplication          = 1301,
   QTErrorDeviceExcludedByAnotherDevice            = 1302,
};

Constants
QTErrorUnknown

Indicates an unexpected or unknown error.

Check NSUnderlyingErrorKey for an NSError representing the internal cause of the error.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorInputAlreadyConnectedToAnotherSession

The input could not be added to the specified session because it is already connected to another session.

Check QTErrorCaptureInputKey for the input experiencing the error.

QTErrorOutputAlreadyConnectedToAnotherSession

The output could not be added to the specified session because it is already connected to another session.

Check QTErrorCaptureOutputKey for the output experiencing the error.

QTErrorIncompatibleInput

The input could not be added to the specified session because it is incompatible with existing inputs and outputs in the session.

Check QTErrorCaptureInputKey for the input experiencing the error.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorIncompatibleOutput

The output could not be added to the specified session because it is incompatible with existing inputs and outputs in the session.

Check QTErrorCaptureOutputKey for the output experiencing the error.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorInvalidInputOrOutput

The input or output could not be added to the specified session because the session experiences a runtime error due to a problem with one of the inputs or outputs.

Check NSUnderlyingErrorKey for an NSError representing the internal cause of the error.

QTErrorDeviceAlreadyUsedbyAnotherSession

The device could not be added to the session because it experiences a runtime error trying to use a device already being used by another session.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorNoDataCaptured

Returned when no data was successfully captured during a recording or other capture operation.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorSessionConfigurationChanged

The recording has been automatically stopped because an input or output has been added or removed, or the channels of an input or output have changed.

Check QTErrorCaptureSuccesfullyFinishedKey to determine if the recorded products were successfully completed when recording was stopped.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorDiskFull

The recording has been automatically stopped because the disk being used for recorded products is full.

Check QTErrorCaptureSuccesfullyFinishedKey to determine if the recorded products were successfully completed when recording was stopped. This error will occur while the destination disk still has sufficient space to avoid system wide warnings about low disk space.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorDeviceWasDisconnected

The recording has been automatically stopped because an input device was disconnected.

Check QTErrorCaptureSuccesfullyFinishedKey to determine if the capture products were successfully completed when recording was stopped.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorMediaChanged

The recording has been automatically stopped because the format of the input media changed or the media samples were invalid.

Check QTErrorCaptureSuccesfullyFinishedKey to determine if the capture products were successfully completed when recording was stopped.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorMaximumDurationReached

Returned when recording has reached the maximum duration specified by the application.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorMaximumFileSizeReached

Returned when recording has reached the maximum file size specified by the application.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorMediaDiscontinuity

Returned when there is a discontinuity in captured media, usually because of perfomance problems on the user's system or because of a change in a device's state. This error generally indicates that media samples have been dropped in order to maintain real time capture.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorDeviceNotConnected

The device is not connected to the computer.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorDeviceInUseByAnotherApplication

The device is in use by another application.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.

QTErrorDeviceExcludedByAnotherDevice

The device is excluded by another device.

Check QTErrorExcludingDeviceKey to determine the device that needs to be closed to open the device that failed.

Available in Mac OS X v10.5 and later.

Declared in QTError.h.



Next Page > Hide TOC

© 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-07-19)

Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.