IAudioEndpoint::SetEventHandle-Methode (audioengineendpoint.h)
Die SetEventHandle-Methode legt das Handle für das Ereignis fest, das der Endpunkt verwendet, um zu signalisieren, dass die Verarbeitung eines Puffers abgeschlossen wurde.
Syntax
HRESULT SetEventHandle(
[in] HANDLE eventHandle
);
Parameter
[in] eventHandle
Das Ereignishandle, das zum Aufrufen eines Pufferabschlussrückrufs verwendet wird.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes folgendes, sind jedoch nicht darauf beschränkt.
Hinweise
Die SetEventHandle-Methode legt das Ereignishandle der Audio-Engine auf dem Endpunkt fest. In dieser Implementierung sollte der Aufrufer eine Fehlerantwort von AEERR_NOT_INITIALIZED erhalten, wenn der Audioendpunkt nicht initialisiert wird oder der Puffer nicht durch die SetBuffer-Methode festgelegt wird.
Um Ereignisbenachrichtigungen zu erhalten, hat die Audio-Engine das AUDCLNT_STREAMFLAGS_EVENTCALLBACK-Flag auf dem Endpunkt festgelegt. Um dieses Flag festzulegen, ruft die Audio-Engine die IAudioEndpoint::SetStreamFlags-Methode auf.
Diese Methode darf nicht aus einem Echtzeitverarbeitungsthread aufgerufen werden.
Die AudioEndpoint-API für Remotedesktopdienste ist für die Verwendung in Remotedesktopszenarien vorgesehen. es ist nicht für Clientanwendungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | audioengineendpoint.h |