ILTDVDBurner::put_AutoEject

Summary

Changes the auto-ejecting state.

Syntax

#include "ILTDVDBurner2.h"
Platform Syntax
C HRESULT ILTDVDBurner_put_AutoEject(pDVDBurner, newVal)
C++ HRESULT put_AutoEject(newVal)

Parameters

ILTDVDBurner *pDVDBurner

Pointer to an ILTDVDBurner interface.

VARIANT_BOOL newVal

Flag that indicates the new value of the auto-ejecting state. Possible values are:

Value Meaning
VARIANT_TRUE Eject the tray immediately after the completion of the burn operation. This is the default value.
VARIANT_FALSE Keep the tray closed after the completion of the burn operation.

Returns

Value Meaning
S_OK The function was successful.
<> S_OK An error occurred. Refer to the Error Codes.

Comments

It is best to use AutoEject because some disk drives do not recognize data from the disk unless you eject the disk and put it back in. If you do not eject the disk and try to look at the contents of the disk after the burning completes, the computer might treat the disk as empty when it reality it contains some data. This behavior varies from one drive to another. So the safest approach is to force a disk ejection after you burn data to a disk.

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Functions

Topics

Example

For a C example, refer to ILTDVDBurner::get_AutoEject Example for C.

For a C++ example, refer to ILTDVDBurner::get_AutoEject Example for C++.

Help Version 23.0.2024.3.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Media Writer C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.