Constantes de ubicación de biblioteca

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota:

En esta sección se describe la funcionalidad diseñada para su uso por las tiendas en línea. No se admite el uso de esta funcionalidad fuera del contexto de una tienda en línea.

 

Las constantes de ubicación de la biblioteca son variables de cadena globales definidas en contentpartner.h. Se usan mediante determinados métodos de las interfaces IWMPContentPartner e IWMPContentPartnerCallback y por determinados métodos del objeto External . Estas constantes se usan para indicar los siguientes tipos.

• Tipo de ubicación de biblioteca: este es el tipo de vista de biblioteca que se muestra en Reproductor multimedia de Windows. Por ejemplo, el Reproductor podría mostrar una vista de un álbum determinado (g_szCPAlbumID) o la vista de todos los géneros (g_szAllCPGenreIDs).
• Tipo de elemento seleccionado: es el tipo de elemento seleccionado en la vista de biblioteca. Por ejemplo, el usuario puede seleccionar un álbum determinado (g_szCPAlbumID) en la vista de todos los álbumes.
• Tipo de lista: este es el tipo de lista que se solicita desde el complemento de asociado de contenido. Por ejemplo, Reproductor multimedia de Windows puede pedir al complemento que proporcione una lista de elementos asociados a una lista de reproducción determinada (g_szCPListID).
• Tipo de elemento de lista: el tipo de elemento de lista individual que se solicita desde el complemento de asociado de contenido. Por ejemplo, Reproductor multimedia de Windows puede pedir al complemento que proporcione la lista de pistas (g_szCPTrackID) en una lista de reproducción determinada.

En la tabla siguiente se proporciona el nombre y el valor de cada constante, y una breve descripción de la ubicación o el tipo de biblioteca. En el código de C o C++ que se compila con el archivo de encabezado contentpartner.h, puede usar el nombre o el valor de una constante. Es preferible usar el nombre porque el compilador detectará errores ortográficos. En script (por ejemplo, al llamar a los métodos del objeto External ), no se puede usar el nombre de una constante; debe usar el valor .

Nombre	Value	Ubicación o tipo
g_szUnknownLocation	UnknownLocation	Un conjunto de pistas que no es un álbum ni una lista de reproducción. Reproductor multimedia de Windows también usa esta constante en el caso poco frecuente de que no pueda determinar una ubicación válida.
g_szRootLocation	RootLocation	Nodo superior del control de vista de árbol de biblioteca
g_szFlyoutMenu	FlyoutMenu	Menú flotante de la tienda en línea actual
g_szOnlineStore	OnlineStore	Todas las tiendas en línea
g_szCPListID	CPListID	Una lista individual
g_szAllCPListIDs	AllCPListIDs	Todas las listas
g_szCPTrackID	CPTrackID	Una pista individual
g_szAllCPTrackIDs	AllCPTrackIDs	Todas las pistas
g_szCPArtistID	CPArtistID	Un artista individual
g_szAllCPArtistIDs	AllCPArtistIDs	Todos los artistas
g_szCPAlbumID	CPAlbumID	Un álbum individual
g_szAllCPAlbumIDs	AllCPAlbumIDs	Todos los álbumes
g_szCPGenreID	CPGenreID	Un género individual
g_szAllCPGenreIDs	AllCPGenreIDs	Todos los géneros
g_szCPAlbumSubGenreID	CPAlbumSubGenreID	Un subgene individual
g_szAllCPAlbumSubGenreIDs	AllCPAlbumSubGenreIDs	Todos los subgenes
g_szReleaseDateYear	ReleaseDateYear	Un año individual en el que se publicó el contenido del catálogo
g_szAllReleaseDateYears	AllReleaseDateYears	Todos los años en los que se publicó el contenido del catálogo
g_szCPRadioID	CPRadioID	Una secuencia de radio individual
g_szAllCPRadioIDs	AllCPRadioIDs	Todas las secuencias de radio
g_szAuthor	Autor	Un autor individual
g_szAllAuthors	AllAuthors	Todos los autores
g_szWMParentalRating	WMParentalRating	Una clasificación parental individual
g_szAllWMParentalRatings	AllWMParentalRatings	Todas las clasificaciones parentales
g_szUserEffectiveRatingStars	UserEffectiveRatingStars	Una clasificación de usuario individual, medida como un número de estrellas
g_szAllUserEffectiveRatingStarss	AllUserEffectiveRatingStarss	Todas las clasificaciones de usuario

 

Temas relacionados

External.addToBasket

External.buy

External.changeView

External.changeViewOnlineList

External.download

External.libraryLocationType

External.play

IWMPContentPartner::GetCommands

IWMPContentPartner::GetListContents

IWMPContentPartner::GetTemplate

IWMPContentPartner::InvokeCommand

IWMPContentPartnerCallback::ChangeView