Método CMediaControl.GetIDsOfNames

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, 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.]

Mapeia uma única função membro e um conjunto opcional de parâmetros para um conjunto correspondente de DISPIDs (identificadores de expedição de inteiros), que podem ser usados em chamadas subsequentes para a função membro CMediaControl::Invoke .

Sintaxe

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

Parâmetros

riid

Identificador de referência. Reservado para uso futuro. Deve ser NULL.

rgszNames

Endereço de um ponteiro para uma matriz passada de nomes a serem mapeados.

Cnames

Contagem dos nomes a serem mapeados.

lcid

Contexto de localidade no qual interpretar os nomes.

rgdispid

Ponteiro para uma matriz alocada pelo chamador, cada elemento do qual contém uma ID correspondente a um dos nomes passados na matriz rgszNames . O primeiro elemento representa o nome do membro; os elementos subsequentes representam cada um dos parâmetros do membro.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno Descrição
DISP_E_UNKNOWN_CLSID
O CLSID não foi reconhecido.
DISP_E_UNKNOWNNAME
Um ou mais nomes não eram conhecidos. Os DISPIDs retornados contêm DISPID_UNKNOWN para cada entrada que corresponde a um nome desconhecido.
E_OUTOFMEMORY
Sem memória.
S_OK
Êxito.

Requisitos

Requisito Valor
parâmetro
Ctlutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CMediaControl