Unit Codec

Return to Unit Reference

Description

---

Ultibo Codec Interface unit

Constants

---

[Expand]

Codec specific constants CODEC_*

CODEC_NAME_PREFIX = 'Codec';

Name prefix for Codec Devices

[Expand]

Codec device type CODEC_TYPE_*

CODEC_TYPE_NONE = 0;

[Expand]

Codec device state CODEC_STATE_*

CODEC_STATE_DISABLED = 0;
CODEC_STATE_ENABLED = 1;

[Expand]

Codec device flag CODEC_FLAG_*

CODEC_FLAG_NONE = $00000000;

[Expand]

Codec logging CODEC_LOG_*

CODEC_LOG_LEVEL_DEBUG = LOG_LEVEL_DEBUG;	Codec debugging messages
CODEC_LOG_LEVEL_INFO = LOG_LEVEL_INFO;	Codec informational messages, such as a device being attached or detached
CODEC_LOG_LEVEL_WARN = LOG_LEVEL_WARN;	Codec warning messages
CODEC_LOG_LEVEL_ERROR = LOG_LEVEL_ERROR;	Codec error messages
CODEC_LOG_LEVEL_NONE = LOG_LEVEL_NONE;	No Codec messages

Type definitions

---

Codec properties

[Expand]

PCodecProperties = ^TCodecProperties;

TCodecProperties = record

Flags:LongWord;

Device flags (eg CODEC_FLAG_????)

Codec enumeration callback

TCodecEnumerate = function(Codec:PCodecDevice; Data:Pointer):LongWord;

Codec notification callback

TCodecNotification = function(Device:PDevice; Data:Pointer; Notification:LongWord):LongWord;

Codec device get properties

TCodecDeviceGetProperties = function(Codec:PCodecDevice; Properties:PCodecProperties):LongWord;

Codec device

[Expand]

PCodecDevice = ^TCodecDevice;

TCodecDevice = record

Device Properties
Device:TDevice;	The Device entry for this Codec device
Codec Properties
CodecId:LongWord;	Unique Id of this Codec device in the Codec device table
CodecState:LongWord;	Codec device state (eg CODEC_STATE_ENABLED)
DeviceGetProperties:TCodecDeviceGetProperties;	A Device specific DeviceGetProperties method implementing the standard Codec device interface (Or nil if the default method is suitable)
Driver Properties
Lock:TMutexHandle;	Device lock
Properties:TCodecProperties;	Device properties
Internal Properties
Prev:PCodecDevice;	Previous entry in Codec device table
Next:PCodecDevice;	Next entry in Codec device table

Public variables

---

Codec logging

CODEC_DEFAULT_LOG_LEVEL:LongWord = CODEC_LOG_LEVEL_DEBUG;

Minimum level for Codec messages. Only messages with level greater than or equal to this will be printed.

CODEC_LOG_ENABLED:Boolean;

Function declarations

---

Initialization functions

[Expand]

procedure CodecInit;

Description: Initialize the Codec unit and Codec device table

Note	Called only during system startup

Codec device functions

[Expand]

function CodecDeviceGetProperties(Codec:PCodecDevice; Properties:PCodecProperties):LongWord;

Description: Get the properties for the specified Codec device

Codec	The Codec device to get properties from
Properties	Pointer to a TCodecProperties structure to fill in
Return	ERROR_SUCCESS if completed or another error code on failure

[Expand]

function CodecDeviceCreate:PCodecDevice;

Description: Create a new Codec device entry

Return	Pointer to new Codec device entry or nil if Codec device could not be created

[Expand]

function CodecDeviceCreateEx(Size:LongWord):PCodecDevice;

Description: Create a new Codec device entry

Size	Size in bytes to allocate for new Codec device (Including the Codec device entry)
Return	Pointer to new Codec device entry or nil if Codec device could not be created

[Expand]

function CodecDeviceDestroy(Codec:PCodecDevice):LongWord;

Description: Destroy an existing Codec device entry

Note	None documented

[Expand]

function CodecDeviceRegister(Codec:PCodecDevice):LongWord;

Description: Register a new Codec device in the Codec device table

Note	None documented

[Expand]

function CodecDeviceDeregister(Codec:PCodecDevice):LongWord;

Description: Deregister an Codec device from the Codec device table

Note	None documented

[Expand]

function CodecDeviceFind(CodecId:LongWord):PCodecDevice;

Description: To be documented

Note	None documented

[Expand]

function CodecDeviceFindByName(const Name:String):PCodecDevice; inline;

Description: To be documented

Note	None documented

[Expand]

function CodecDeviceFindByDescription(const Description:String):PCodecDevice; inline;

Description: To be documented

Note	None documented

[Expand]

function CodecDeviceEnumerate(Callback:TCodecEnumerate; Data:Pointer):LongWord;

Description: To be documented

Note	None documented

[Expand]

function CodecDeviceNotification(Codec:PCodecDevice; Callback:TCodecNotification; Data:Pointer; Notification,Flags:LongWord):LongWord;

Description: To be documented

Note	None documented

Codec helper functions

[Expand]

function CodecGetCount:LongWord;

Description: Get the current Codec device count

Note	None documented

[Expand]

function CodecDeviceGetDefault:PCodecDevice;

Description: Get the current default Codec device

Note	None documented

[Expand]

function CodecDeviceSetDefault(Codec:PCodecDevice):LongWord; 

Description: Set the current default Codec device

Note	None documented

[Expand]

function CodecDeviceCheck(Codec:PCodecDevice):PCodecDevice;

Description: Check if the supplied Codec device is in the Codec device table

Note	None documented

[Expand]

procedure CodecLog(Level:LongWord; Codec:PCodecDevice; const AText:String);

Description: To be documented

Note	None documented

[Expand]

procedure CodecLogInfo(Codec:PCodecDevice; const AText:String); inline;

Description: To be documented

Note	None documented

[Expand]

procedure CodecLogWarn(Codec:PCodecDevice; const AText:String); inline;

Description: To be documented

Note	None documented

[Expand]

procedure CodecLogError(Codec:PCodecDevice; const AText:String); inline;

Description: To be documented

Note	None documented

[Expand]

procedure CodecLogDebug(Codec:PCodecDevice; const AText:String); inline;

Description: To be documented

Note	None documented

Return to Unit Reference