ILTDVDBurner::GetDiscTypeName
#include "ILTDVDBurner2.h"
C Syntax |
HRESULT LTDVDBurner__getDiscTypeName(pDVDBurner, type, pVal) |
C++ Syntax |
HRESULT GetDiscTypeName(type, pVal) |
ILTDVDBurner *pDVDBurner; |
/* pointer to an interface */ |
long type; |
/* disc type */ |
BSTR *pVal; |
/* pointer to a string */ |
Retrieves the name of the disc type.
Parameter |
Description |
pDVDBurner |
Pointer to an ILTDVDBurner interface. |
type |
Value that represents the type of the disc for which to retrieve its name. For all possible values, refer to the ILTDVDBurner::get_DiscType function. |
pVal |
Pointer to a character string to be updated with name of the disc type. Possible values are: |
|
"None" |
|
"Unknown" |
|
"CD-ROM" |
|
"CD-R" |
|
"CD-RW" |
|
"DVD-ROM" |
|
"DVD-R" |
|
"DVD-RW" |
|
"DVD-RAM" |
|
"DVD+RW" |
|
"DVD+R" |
|
"DVD+R DL" |
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
If the function succeeds, the user is responsible for freeing the retrieved disc type string by calling SysFreeString.
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. |
See Also
Example
For a C example, refer to ILTDVDBurner::GetDiscTypeName Example for C.
For a C++ example, refer to ILTDVDBurner::GetDiscTypeName Example for C++.