Para carregar um perfil do sistema

  • Artigo

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador de Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador de Coletor em vez do SDK do Windows Media Format 11, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Para fazer alterações em um perfil do sistema, você deve carregá-lo em um objeto de perfil. O gerenciador de perfil fornece duas opções para carregar perfis do sistema: por identificador e por índice.

Um identificador de perfil do sistema é um valor GUID atribuído ao perfil do sistema quando ele foi criado. Para obter uma lista das constantes GUID associadas aos perfis do sistema da versão 8, consulte Perfis do sistema. Você pode encontrar as constantes GUID para versões anteriores no arquivo de cabeçalho WMSysPrf.h. Para obter mais informações sobre esse e outros arquivos de cabeçalho incluídos no SDK de Formato de Mídia do Windows, consulte Arquivos de Biblioteca e Configurações do Compilador.

O código de exemplo a seguir demonstra como carregar um perfil do sistema usando o identificador de perfil do sistema. Para que esse código funcione, você deve incluir WMSysPrf.h e stdio.h. Para obter mais informações sobre como usar esse código, consulte Usando os exemplos de código.

IWMProfileManager* pProfileMgr = NULL;
IWMProfile*        pProfile    = NULL;

HRESULT hr = S_OK;

// Initialize COM.
hr = CoInitialize(NULL);

// Create a profile manager.
hr = WMCreateProfileManager(&pProfileMgr);

// Retrieve the data for the general-purpose broadband video profile.
hr = pProfileMgr->LoadProfileByID(WMProfile_V80_100Video, &pProfile);

// TODO: Perform whatever customizations are needed. For details about
// editing profiles, see Using Custom Profiles.

// Clean up.
pProfile->Release();
pProfile = NULL;
pProfileMgr->Release();
pProfileMgr = NULL;

Se você não souber qual perfil deseja usar, poderá iterar todos os perfis do sistema de uma versão específica usando os métodos GetSystemProfileCount e LoadSystemProfile da interface IWMProfileManager . Esses métodos lidam apenas com uma versão dos perfis do sistema por vez. Para obter mais informações sobre como alterar a versão do perfil do sistema, consulte Para alterar as versões de perfil do sistema.

Usando perfis do sistema