Starts recording a new video file.

Namespace: ASCOM.DeviceInterface
Assembly: ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 6.0.0.0 (6.1.1.2619)

Syntax

C#
string StartRecordingVideoFile(
	string PreferredFileName
)
Visual Basic
Function StartRecordingVideoFile ( _
	PreferredFileName As String _
) As String
Visual C++
String^ StartRecordingVideoFile(
	String^ PreferredFileName
)

Parameters

PreferredFileName
Type: System..::..String
The file name requested by the client. Some systems may not allow the file name to be controlled directly and they should ignore this parameter.

Return Value

The actual file name of the file that is being recorded.

Exceptions

ExceptionCondition
MethodNotImplementedExceptionMust throw exception if not implemented.
NotConnectedExceptionMust throw exception if not connected.
InvalidOperationExceptionMust throw exception if the current camera state doesn't allow to begin recording a file.
DriverExceptionMust throw exception if there is any other problem as result of which the recording cannot begin.

See Also