CMediaEvent.GetIDsOfNames-Methode
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Ordnet eine einzelne Memberfunktion und einen optionalen Satz von Parametern einem entsprechenden Satz ganzzahliger Dispatch-Bezeichner zu, die bei nachfolgenden Aufrufen der CMediaEvent::Invoke-Memberfunktion verwendet werden können.
Syntax
HRESULT GetIDsOfNames(
REFIID riid,
OLECHAR **rgszNames,
UINT cNames,
LCID lcid,
DISPID *rgdispid
);
Parameter
-
riid
-
Referenzbezeichner. 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 zugewiesenes Array, dessen jedes Element eine ID enthält, die einem der im rgszNames-Array übergebenen Namen entspricht. Das erste Element stellt den Membernamen dar. die nachfolgenden Elemente stellen die parameter des Elements dar.
Rückgabewert
Gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Die CLSID wurde nicht erkannt. |
|
Mindestens ein Name war nicht bekannt. Die zurückgegebenen DISPIDs enthalten DISPID_UNKNOWN für jeden Eintrag, der einem unbekannten Namen entspricht. |
|
Nicht genügend Arbeitsspeicher. |
|
Erfolg. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|