ADC Home > Reference Library > Reference > Darwin > Kernel Framework Reference

IOBDMedia

Inherits from:	IOMedia
Declared In:	IOBDMedia.h

Overview

The IOBDMedia class is a random-access disk device abstraction for BDs.

Discussion

The IOBDMedia class is a random-access disk device abstraction for BDs.

Functions

getSpeed
readDiscInfo
readStructure
readTrackInfo
reportKey
sendKey
setSpeed
splitTrack

getSpeed

public

virtual IOReturn getSpeed(
    UInt16 *kilobytesPerSecond);

Parameters

kilobytesPerSecond

Returns the current speed used for data transfers, in kB/s.

kBDSpeedMin specifies the minimum speed for all BD media (1X). kBDSpeedMax specifies the maximum speed supported in hardware.

Return Value

Returns the status of the operation.

Discussion

Get the current speed used for data transfers.

readDiscInfo

public

virtual IOReturn readDiscInfo(
    IOMemoryDescriptor *buffer, 
    UInt8 type, 
    UInt16 *actualByteCount );

Parameters

buffer: Buffer for the data transfer. The size of the buffer implies the size of the data transfer.
type: Reserved for future use. Set to zero.
actualByteCount: Returns the actual number of bytes transferred in the data transfer.

Return Value

Returns the status of the data transfer.

Discussion

Issue an MMC READ DISC INFORMATION command.

readStructure

public

virtual IOReturn readStructure(
    IOMemoryDescriptor *buffer, 
    UInt8 format, 
    UInt32 address, 
    UInt8 layer, 
    UInt8 grantID );

Parameters

buffer: Buffer for the data transfer. The size of the buffer implies the size of the data transfer.
format: As documented by MMC.
address: As documented by MMC.
layer: As documented by MMC.
grantID: As documented by MMC.

Return Value

Returns the status of the data transfer.

Discussion

Issue an MMC READ DISC STRUCTURE command.

readTrackInfo

public

virtual IOReturn readTrackInfo(
    IOMemoryDescriptor *buffer, 
    UInt32 address, 
    UInt8 addressType, 
    UInt8 open, 
    UInt16 *actualByteCount );

Parameters

buffer: Buffer for the data transfer. The size of the buffer implies the size of the data transfer.
address: As documented by MMC.
addressType: As documented by MMC.
open: Reserved for future use. Set to zero.
actualByteCount: Returns the actual number of bytes transferred in the data transfer.

Return Value

Returns the status of the data transfer.

Discussion

Issue an MMC READ TRACK INFORMATION command.

reportKey

public

virtual IOReturn reportKey(
    IOMemoryDescriptor *buffer, 
    UInt8 keyClass, 
    UInt32 address, 
    UInt8 grantID, 
    UInt8 format );

Parameters

buffer: Buffer for the data transfer. The size of the buffer implies the size of the data transfer.
keyClass: As documented by MMC.
address: As documented by MMC.
grantID: As documented by MMC.
format: As documented by MMC.

Return Value

Returns the status of the data transfer.

Discussion

Issue an MMC REPORT KEY command.

sendKey

public

virtual IOReturn sendKey(
    IOMemoryDescriptor *buffer, 
    UInt8 keyClass, 
    UInt8 grantID, 
    UInt8 format );

Parameters

buffer: Buffer for the data transfer. The size of the buffer implies the size of the data transfer.
keyClass: As documented by MMC.
grantID: As documented by MMC.
format: As documented by MMC.

Return Value

Returns the status of the data transfer.

Discussion

Issue an MMC SEND KEY command.

setSpeed

public

virtual IOReturn setSpeed(
    UInt16 kilobytesPerSecond);

Parameters

kilobytesPerSecond

Speed to be used for data transfers, in kB/s.

kBDSpeedMin specifies the minimum speed for all BD media (1X). kBDSpeedMax specifies the maximum speed supported in hardware.

Return Value

Returns the status of the operation.

Discussion

Set the speed to be used for data transfers.

splitTrack

public

virtual IOReturn splitTrack(
    UInt32 address);

Parameters

address: As documented by MMC.

Return Value

Returns the status of the operation.

Discussion

Issue an MMC RESERVE TRACK command with the ARSV bit.

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.

Last Updated: 2008-12-19