CMediaControl.GetIDsOfNames-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Ordnet eine einzelne Memberfunktion und einen optionalen Satz von Parametern einem entsprechenden Satz von DISPIDs (Integer Dispatch Identifiers) zu, die bei nachfolgenden Aufrufen der CMediaControl::Invoke-Memberfunktion verwendet werden können.

Syntax

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

Parameter

riid

Verweisbezeichner. Für die zukünftige Verwendung reserviert. Muss NULL sein.

rgszNames

Adresse eines Zeigers auf ein übergebenes Array von Namen, die zugeordnet werden sollen.

cNames

Die Anzahl der zuzuordnenden Namen.

lcid

Gebietsschemakontext, in dem die Namen interpretiert werden sollen.

rgdispid

Zeiger auf ein vom Aufrufer zugeordnetes Array, dessen Jedes Element eine ID enthält, die einem der Namen entspricht, die im rgszNames-Array übergeben werden. Das erste Element stellt den Membernamen dar; die nachfolgenden Elemente stellen jeden Parameter des Members dar.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
DISP_E_UNKNOWN_CLSID	Die CLSID wurde nicht erkannt.
DISP_E_UNKNOWNNAME	Mindestens einer der Namen war nicht bekannt. Die zurückgegebenen DISPIDs enthalten DISPID_UNKNOWN für jeden Eintrag, der einem unbekannten Namen entspricht.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
S_OK	Erfolg.

Anforderungen

Anforderung	Wert
Header	Ctlutil.h (Streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CMediaControl-Klasse