Mac Developer Library

Developer

IODVDMedia Class Reference

Options
Deployment Target:

On This Page
Language:

IODVDMedia

The IODVDMedia class is a random-access disk device abstraction for DVDs. More...

Inheritance


Not Applicable

Conforms To


Not Applicable

Import Statement


Not Applicable @import Kernel;

Availability


Available in OS X v10.6 and later.
  • Declaration

    C++

    virtual IOReturn getSpeed( UInt16 *kilobytesPerSecond);

    Parameters

    kilobytesPerSecond

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

    kDVDSpeedMin specifies the minimum speed for all DVD media (1X). kDVDSpeedMax specifies the maximum speed supported in hardware.

    Return Value

    Returns the status of the operation.

    Discussion

    Get the current speed used for data transfers.

    Import Statement

  • Declaration

    C++

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

    Parameters

    buffer

    Buffer for the data transfer. The size of the buffer implies the size of the data transfer.

    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.

    Import Statement

  • Declaration

    C++

    virtual IOReturn readRZoneInfo( IOMemoryDescriptor *buffer, UInt32address, DVDRZoneInfoAddressTypeaddressType, 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.

    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 RZONE INFORMATION (READ TRACK INFORMATION) command.

    Import Statement

  • Declaration

    C++

    virtual IOReturn readStructure( IOMemoryDescriptor *buffer, const DVDStructureFormatformat, const UInt32address, const UInt8layer, const UInt8grantID );

    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 DVD STRUCTURE command.

    Import Statement

  • Declaration

    C++

    virtual IOReturn reportKey( IOMemoryDescriptor *buffer, const DVDKeyClasskeyClass, const UInt32address, const UInt8grantID, const DVDKeyFormatformat );

    Parameters

    buffer

    Buffer for the data transfer. The size of the buffer implies the size of the data transfer. Pass null for the kDVDKeyFormatAGID_Invalidate format case.

    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.

    Import Statement

  • Declaration

    C++

    virtual IOReturn sendKey( IOMemoryDescriptor *buffer, const DVDKeyClasskeyClass, const UInt8grantID, const DVDKeyFormatformat );

    Parameters

    buffer

    Buffer for the data transfer. The size of the buffer implies the size of the data transfer. Pass null for the kDVDKeyFormatAGID_Invalidate format case.

    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.

    Import Statement

  • Declaration

    C++

    virtual IOReturn setSpeed( UInt16kilobytesPerSecond);

    Parameters

    kilobytesPerSecond

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

    kDVDSpeedMin specifies the minimum speed for all DVD media (1X). kDVDSpeedMax 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.

    Import Statement