ILTDVDBurner::get_Loadable

#include "ILTDVDBurner2.h"

C Syntax

HRESULT LTDVDBurner_get_Loadable(pDVDBurner, pVal)

C++ Syntax

HRESULT get_Loadable(pVal)

 

ILTDVDBurner *pDVDBurner;

/* pointer to an interface */

VARIANT_BOOL *pVal;

/* pointer to a variable */

Retrieves a value that indicates whether the drive can be loaded at the current time.

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

pVal

Pointer to a variable to be updated with a value that indicates whether the drive can be loaded at the current time. Possible values are:

 

Value

Meaning

 

VARIANT_TRUE

The drive can be loaded at the current time.

 

VARIANT_FALSE

The drive can not be loaded at the current time.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

The burner must be in the idle state and the drive door must be open in order for the drive to be loadable.

Required DLLs and Libraries

LTDVDBrn

DSKernel (Multimedia toolkit)  or LTKRN (Imaging Pro, Document, or Medical toolkits)

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Functions:

ILTDVDBurner::LoadDisc

Topics:

Video Streaming Function Groups, Multimedia Function Groups, DVD Function Groups,

Example

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

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