ICodecAPI::RegisterForEvent-Methode (icodecapi.h)
Die RegisterForEvent-Methode registriert die Anwendung, um Ereignisse vom Codec zu empfangen.
Syntax
HRESULT RegisterForEvent(
[in] const GUID *Api,
[out] LONG_PTR userData
);
Parameter
[in] Api
Zeiger auf eine GUID, die das Ereignis angibt. Es gibt drei Kategorien von Ereignissen:
Wert | Bedeutung |
---|---|
|
Der Codec benachrichtigt die Anwendung, wenn sich die Eigenschaften des Codecs ändern. Die Ereignisdaten sind eine Liste von GUIDs für die geänderten Eigenschaften. |
|
Der Codec benachrichtigt die Anwendung, wenn sich die angegebene Eigenschaft ändert. In der Regel unterstützt ein Codec diese Art von Benachrichtigungen für einen begrenzten Satz von Eigenschaften, falls vorhanden. |
|
Implementierungsabhängig. |
[out] userData
Zeiger auf vom Aufrufer definierte Daten. Die Anwendung empfängt diesen Zeiger im lParam1-Ereignisparameter .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Nicht implementiert. Der Codec unterstützt keine Ereignisbenachrichtigung oder die im Api-Parameter angegebene Ereignis-GUID. |
Hinweise
Die Anwendung empfängt eine EC_CODECAPI_EVENT Ereignisbenachrichtigung, wenn der Encodercodec das Ereignis sendet. Zum Abrufen des Ereignisses verwendet die IMediaEventEx-Schnittstelle .
Der lParam2-Parameter des Ereignisses ist ein Zeiger auf eine CodecAPIEventData-Struktur . Dieser Struktur können zusätzliche Daten folgen, abhängig von der Ereignis-GUID. Die Größe dieser Daten wird vom dataLength-Element angegeben.
GUID | Ereignisdaten |
---|---|
CODECAPI_CHANGELISTS | Ein Array von GUIDs. Jede GUID gibt eine Codeceigenschaft an, deren aktueller Wert oder gültiger Bereich geändert wurde. Die Größe des Arrays ist dataLength / sizeof(GUID) . |
Eine in codecapi.h definierte Eigenschafts-GUID. | Keine. |
Proprietäre Ereignis-GUID. | Implementierungsabhängig. |
Wenn der Codec das angegebene Ereignis nicht unterstützt, gibt die Methode E_NOTIMPL zurück. Der Codec unterstützt möglicherweise andere Ereignisse.
Um Benachrichtigungen für ein Ereignis zu deaktivieren, rufen Sie ICodecAPI::UnregisterForEvent auf.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 10 Build 20348 |
Unterstützte Mindestversion (Server) | Windows 10 Build 20348 |
Kopfzeile | icodecapi.h |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für