IDvdInfo::GetDVDTextInfo
Microsoft DirectShow 9.0 |
IDvdInfo::GetDVDTextInfo
- Note The IDvdInfo interface is deprecated. Use IDvdInfo2 instead.
Retrieves the TXTDT_MG structure, which can contain text descriptions for title name, volume name, producer name, vocalist name, and so on, in various languages.
Syntax
HRESULT GetDVDTextInfo( BYTE *pTextManager, ULONG cbBufSize, ULONG *pcbActualSize );
Parameters
pTextManager
[out, size_is(cbBufSize)] Pointer to the retrieved text manager.
cbBufSize
[in] Size of the buffer for pTextManager, in bytes.
pcbActualSize
[out] Pointer to a value containing the number of bytes of data returned.
Return Value
Returns an HRESULT value .
Return code | Description |
E_UNEXPECTED | DVD is not initialized or domain is not DVD_DOMAIN_Title. |
S_OK | Success. |
VFW_E_DVD_INVALIDDOMAIN | Requested action is not supported on this domain (DVD_DOMAIN). |
VFW_E_DVD_OPERATION_INHIBITED | Requested action cannot occur at this point in the movie due to the authoring of the current DVD-Video disc. |
Remarks
This method is valid in any domain. For more information, see DVD_DOMAIN.
If the supplied buffer size in cbBufSize is too small for the data, (for example if cbBufSize equals zero), then this method returns E_OUTOFMEMORY and sets the value pointed to by pcbActualSize to the required size.
For more information, refer to Section 4.1.6 and Annex A of the DVD-Video specification.
Requirements
Reference: Dshow.h.
Library: Quartz.dll.
See Also