IAudioChannelConfig::SetChannelConfig-Methode (devicetopology.h)
Die SetChannelConfig-Methode legt die Kanalkonfigurationsmaske in einem Kanalkonfigurationssteuerelement fest.
Syntax
HRESULT SetChannelConfig(
[in] DWORD dwConfig,
[in] LPCGUID pguidEventContext
);
Parameter
[in] dwConfig
Die Kanalkonfigurationsmaske.
[in] pguidEventContext
Kontextwert für die IControlChangeNotify::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetChannelConfig-Aufruf den Status des Kanalkonfigurationssteuerelements ändert, erhalten alle Clients, die IControlChangeNotify-Schnittstellen mit diesem Steuerelement registriert haben, Benachrichtigungen. Bei der Implementierung der OnNotify-Methode kann ein Client die Ereigniskontext-GUID überprüfen, um zu ermitteln, ob er oder ein anderer Client die Quelle des Steuerelementänderungsereignisses ist. Wenn der Aufrufer einen NULL-Zeiger für diesen Parameter bereitstellt, empfängt die Benachrichtigungsmethode des Clients einen NULL-Kontextzeiger .
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
Rückgabecode | Beschreibung |
---|---|
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Informationen zu Kanalkonfigurationsmasken finden Sie in der Beschreibung der KSPROPERTY_AUDIO_CHANNEL_CONFIG-Eigenschaft in der Windows DDK-Dokumentation.
Anforderungen
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | devicetopology.h |