IWMPContentPartner::GetTemplate method (contentpartner.h)
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Syntax
HRESULT GetTemplate(
[in] WMPTaskType task,
[in] BSTR location,
[in] VARIANT *pContext,
[in] BSTR clickLocation,
[in] VARIANT *pClickContext,
[in] BSTR bstrFilter,
[in] BSTR bstrViewParams,
[out] BSTR *pbstrTemplateURL,
[out] WMPTemplateSize *pTemplateSize
);
Parameters
[in] task
A member of the WMPTaskType enumeration that specifies the active task pane.
[in] location
A library location constant that specifies the type of library view the user is currently seeing. For example, the constant g_szCPListID specifies that the user is viewing a pane that shows a particular playlist.
[in] pContext
The ID of the specific item the user is currently seeing. For example, if location is g_szCPListID, then this parameter specifies the ID of the particular playlist that the user is seeing.
[in] clickLocation
A library location constant that specifies the type of item the user has selected. For example, the constant g_szCPTrackID specifies that the user has selected a particular music track.
[in] pClickContext
The ID of the particular item the user has selected. For example, if clickLocation is g_szCPTrackID, then this parameter specifies the ID of the particular track that the user has selected.
[in] bstrFilter
The filter for the current library view. This is the text that the user entered in the Player's word wheel control.
[in] bstrViewParams
Parameters, meaningful only to the online store, associated with the new library location. See Remarks.
[out] pbstrTemplateURL
Pointer to a BSTR that receives the URL of the discovery page to display.
[out] pTemplateSize
Receives a member of the WMPTemplateSize enumeration that indicates the size of the template in which the Player will display the discovery page.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
Remarks
Windows Media Player calls this method when the view changes in the Library, Sync, or Burn pane. The Player also calls this method when one of those three panes becomes active. The pane or view can change as a result of user navigation or as the result of a call from the discovery page.
When the discovery page calls External.changeView, it sets the ViewParams parameter to whatever context it wants to associate with the new view. Windows Media Player passes that context along to the plug-in in the bstrViewParams parameter of GetTemplate.
When the discovery page calls External.changeViewOnlineList, it sets the Params parameter to whatever context it wants to associate with the new view. Windows Media Player passes that context along to the plug-in in the bstrViewParams parameter of GetTemplate.
If the view changes as a result of user navigation, Windows Media Player sets the bstrParams parameter to NULL when it calls GetTemplate.
Windows Media Player calls GetTemplate to retrieve the URL of the discovery page that it should display in the new view. The Player also receives a WMPTemplateSize value that indicates what portion of the new view should be occupied by the discovery page.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Media Player 11 |
| Target Platform | Windows |
| Header | contentpartner.h |