CMediaControl.GetIDsOfNames-Methode

Artikel
07/28/2023

[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

Freigeben über