© Sonic Solutions. All Rights Reserved.
Welcome to PrimoSDK from Sonic Solutions!
PrimoSDK is a toolkit that makes it easy to add CD and DVD reading and writing capabilities to applications running under the following Microsoft® 32- and 64-bit operating systems: Windows® 98SE, Windows NT 4 (Service Pack 4 or later), Windows Me, Windows 2000, Windows XP/, XP Media Center Edition and Windows Vista.
PrimoSDK's full-featured API is supplied as a DLL that runs on top of the Sonic Record Engine (Px Engine). Functions and parameters have been optimized for calling from C/C++ or Visual Basic applications.
This chapter covers the following topics:
1.1 Using this Guide | go: top |
This Guide is designed to make it as easy as possible to understand what PrimoSDK does and how it is used:
1.2 Key PrimoSDK Capabilities | go: top |
When added to a Windows 32 application, PrimoSDK allows that application to perform a wide range of CD, DVD, and BD (Blu-ray disc) writing and reading operations, including the following:
1.3 PrimoSDK Advantages | go: top |
PrimoSDK offers the following key advantages over competing disc-burning solutions:
1.4 Standard Feature Set | go: top |
PrimoSDK offers a comprehensive set of standard features for both data-centric and audio-centric applications:
NOTE: PrimoSDK-enabled host applications are responsible for power management, which is not handled by the PrimoSDK API. For further information, please refer to the MSDN Summary of OnNow/ACPI Requirements at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnw2kcli/html/w2kcli_chapter6.asp.
1.5 PrimoSDK Options | go: top |
In addition to the standard PrimoSDK feature set outlined above, Sonic offers several PrimoSDK options that may be licensed individually or in any combination to enhance PrimoSDK's capabilities as needed for your specific application:
Every PrimoSDK product (standard and optional) is available in an evaluation version. Write operations with Demo versions are limited to one tenth of the capacity of the recording media (e.g. 7.4 minutes for a 74 minute CD-R). Demo versions are protected by the same restrictions that apply to full versions. The PrimoSDK interface, its examples, and its documentation may not be transmitted, copied, or distributed in any way, totally or in part. For further information, please refer to your PrimoSDK licensing terms or contact your Sonic representative.
! NOTE: For information on which PrimoSDK options (if any) are covered by your license, please contact your Sonic representative.
1.6 PrimoSDK Components | go: top |
The PrimoSDK API is contained in only one DLL (PrimoSDK.dll), which is called using the linking library PrimoSDK.lib and the include file PrimoSDK.h. When using Visual Basic, the programmer will need PrimoSDK.bas, which contains all the constants and function definitions.
Because PrimoSDK.dll is a layer over the Px Engine, when you install an application that uses PrimoSDK, you also need to install all components required for successful operation of Px Engine. PrimoSDK.dll will not load if the Px Engine is not installed. For information on installing the required files, see PrimoSDK Installation in Chapter 2.
PrimoSDK also comes with components for example applications in C and Visual Basic. For further information, see Example Applications in Chapter 2.
1.7 Drive Support | go: top |
Because PrimoSDK runs on top of Px Engine, it supports all the CD and DVD recorders supported by Px Engine. For a list of supported drives, see PrimoSDK_ListSupportedUnits, or launch the sample C application (pxSample_C.exe) and click the CD icon. For information on Px Engine updates, see Updating Px Engine in Chapter 2.
1.8 SDK Support Instructions | go: top |
To report any installation problems, quality issues (bugs, etc.), or feature requests to Sonic, please contact the OEM support personnel assigned to your account.
PrimoSDK includes trace logging capabilities to facilitate troubleshooting. For further information, see Trace Logging in Chapter 3.
1.9 Notices and Disclaimers | go: top |
This Guide published July, 2005. Copyright © Sonic Solutions.
PrimoSDK may be used only under a signed License Agreement with Sonic Solutions. The License Agreement is included with the distributed PrimoSDK files.
PrimoSDK, including the PrimoSDK Guide, is protected by copyright law and international treaties. Except as permitted by license, no part of PrimoSDK may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Sonic Solutions. Unauthorized reproduction or distribution may result in severe civil and criminal penalties.
The information in the PrimoSDK Guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Sonic Solutions. Sonic Solutions assumes no responsibility or liability for any errors or inaccuracies that may appear in this document.
SONIC SOLUTIONS, INC. ("SONIC") MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING THE SOFTWARE. SONIC DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE SONIC SOFTWARE IN TERMS OF ITS CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS, OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE SONIC SOFTWARE IS ASSUMED BY YOU. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES. THE ABOVE EXCLUSION MAY NOT APPLY TO YOU.
IN NO EVENT WILL SONIC, ITS DIRECTORS, OFFICERS, EMPLOYEES, OR AGENTS BY LIABLE TO YOU FOR ANY CONSEQUENTIAL, INCIDENTAL, OR INDIRECT DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, AND THE LIKE) ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE EVEN IF SONIC HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU.
PrimoSDK, PrimoSDK Advanced Audio, PrimoSDK Realtime, PrimoSDK Demo, PrimoSDKPlus, PrimoSDKPlus Demo, Sonic RecordNow, and Px Engine are trademarks of Sonic Solutions. All other trademarks are the property of their respective owners.