Microsoft DirectX 8.0

IAMMediaContent Interface

Retrieves metadata from a stream. Applications can use this interface to retrieve information encoded into a stream, such as the author, title, and copyright. This interface is typically exposed by parser filters, such as the AVI Splitter and the MPEG-1 Stream Splitter.

Depending on the stream type, a filter might support a subset of the methods on this interface. For example, the AVI Splitter retrieves the copyright, author name, and title from INFO chunks in the AVI file. The remaining methods return E_NOTIMPL.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterfaceRetrieves pointers to supported interfaces.
AddRefIncrements the reference count.
ReleaseDecrements the reference count.
IDispatch methodsDescription
GetTypeInfoCountDetermines whether type information is available for this dispinterface.
GetTypeInfoRetrieves the type information for this dispinterface if GetTypeInfoCount returns successfully.
GetIDsOfNamesConverts text names of properties and methods, including arguments, to their corresponding dispatch identifiers (DISPIDs).
InvokeCalls a method or accesses a property in this dispinterface if given a DISPID and any other necessary parameters.
IAMMediaContent methodsDescription
get_AuthorNameRetrieves the author name.
get_TitleRetrieves the title.
get_RatingRetrieves the rating.
get_DescriptionRetrieves a description of the content.
get_CopyrightRetrieves copyright information.
get_BaseURLRetrieves a base URL for the related Web content.
get_LogoURLRetrieves a URL for the logo.
get_LogoIconURLRetrieves a URL for the logo icon.
get_WatermarkURLRetrieves a URL for the watermark.
get_MoreInfoURLRetrieves a URL for additional information about the content.
get_MoreInfoBannerImageRetrieves an image for a related-information banner.
get_MoreInfoBannerURLRetrieves a URL for a related-information banner.
get_MoreInfoTextRetrieves additional information as text.

IAMMediaContent::get_AuthorName

IAMMediaContent Interface

Retrieves the author name.

Syntax

HRESULT get_AuthorName(
    BSTR *pbstrAuthorName
);

Parameters

pbstrAuthorName
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_Title

IAMMediaContent Interface

Retrieves the title.

Syntax

HRESULT get_Title(
    BSTR *pbstrTitle
);

Parameters

pbstrTitle
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_Rating

IAMMediaContent Interface

Retrieves the rating.

Syntax

HRESULT get_Rating(
    BSTR *pbstrRating
);

Parameters

pbstrRating
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_Description

IAMMediaContent Interface

Retrieves a description of the content.

Syntax

HRESULT get_Description(
    BSTR *pbstrDescription
);

Parameters

pbstrDescription
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_Copyright

IAMMediaContent Interface

Retrieves copyright information.

Syntax

HRESULT get_Copyright(
    BSTR *pbstrCopyright
);

Parameters

pbstrCopyright
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_BaseURL

IAMMediaContent Interface

Retrieves a base URL for the related Web content.

Syntax

HRESULT get_BaseURL(
    BSTR *pbstrBaseURL
);

Parameters

pbstrBaseURL
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_LogoURL

IAMMediaContent Interface

Retrieves a URL for the logo.

Syntax

HRESULT get_LogoURL(
    BSTR *pbstrLogoURL
);

Parameters

pbstrLogoURL
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_LogoIconURL

IAMMediaContent Interface

Retrieves a URL for the logo icon.

Syntax

HRESULT get_LogoIconURL(
    BSTR *pbstrLogoURL
);

Parameters

pbstrLogoURL
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_WatermarkURL

IAMMediaContent Interface

Retrieves a URL for the watermark.

Syntax

HRESULT get_WatermarkURL(
    BSTR *pbstrWatermarkURL
);

Parameters

pbstrWatermarkURL
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_MoreInfoURL

IAMMediaContent Interface

Retrieves a URL for additional information about the content.

Syntax

HRESULT get_MoreInfoURL(
    BSTR *pbstrMoreInfoURL
);

Parameters

pbstrMoreInfoURL
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_MoreInfoBannerImage

IAMMediaContent Interface

Retrieves an image for a related-information banner.

Syntax

HRESULT get_MoreInfoBannerImage(
    BSTR *pbstrMoreInfoBannerImage
);

Parameters

pbstrMoreInfoBannerImage
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_MoreInfoBannerURL

IAMMediaContent Interface

Retrieves a URL for a related-information banner.

Syntax

HRESULT get_MoreInfoBannerURL(
    BSTR *pbstrMoreInfoBannerURL
);

Parameters

pbstrMoreInfoBannerURL
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

IAMMediaContent::get_MoreInfoText

IAMMediaContent Interface

Retrieves additional information as text.

Syntax

HRESULT get_MoreInfoText(
    BSTR *pbstrMoreInfoText
);

Parameters

pbstrMoreInfoText
Pointer to a variable that receives a BSTR with the information.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

S_OKSuccess.
E_NOTIMPLNot implemented.
E_OUTOFMEMORYInsufficient memory.
VFW_E_NOT_FOUNDItem not found.

Remarks

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.