Método CMediaPosition.GetIDsOfNames

Artigo
07/28/2023

[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.]

O GetIDsOfNames método mapeia um conjunto de nomes para um conjunto correspondente de DISPIDs.

Sintaxe

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

Parâmetros

riid: Reservado. Use IID_NULL.
rgszNames: Endereço de uma matriz de cadeias de caracteres largos que contêm os nomes a serem mapeados.
Cnames: Tamanho da matriz fornecida pelo parâmetro rgszNames .
lcid: Contexto de localidade no qual interpretar os nomes. Pode ser NULL.
rgdispid: Ponteiro para uma matriz que recebe os DISPIDs. Cada elemento de recebe um identificador que corresponde a um dos nomes passados no parâmetro rgszNames .

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno	Descrição
S_OK	Êxito.
E_OUTOFMEMORY	Memória insuficiente.
DISP_E_UNKNOWNNAME	Um ou mais nomes não eram conhecidos.

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 CMediaPosition

Compartilhar via