IAudioOutputSelector::SetSelection-Methode (devicetopology.h)
Die SetSelection- Methode wählt eine der Ausgaben der Ausgabeauswahl aus.
Syntax
HRESULT SetSelection(
[in] UINT nIdSelect,
[in] LPCGUID pguidEventContext
);
Parameter
[in] nIdSelect
Die neue Auswahlausgabe. Der Aufrufer sollte diesen Parameter auf die lokale ID eines Teils festlegen, die über einen direkten Link zu einer der Selektorausgaben verfügt.
[in] pguidEventContext
Kontextwert für die IControlChangeNotify::OnNotify-Methode. Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetSelection- Aufruf den Zustand des Ausgabeauswahlsteuerelements ändert, werden alle Clients, die IControlChangeNotify Schnittstellen mit diesem Steuerelement empfangen, registriert. Bei der Implementierung der OnNotify-Methode kann ein Client die Ereigniskontext-GUID überprüfen, um zu ermitteln, ob es sich bei ihm oder einem anderen Client um die Quelle des Steuerelementänderungsereignisses handelt. 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, enthalten mögliche Rückgabecodes, sind jedoch nicht beschränkt auf die in der folgenden Tabelle gezeigten Werte.
| Rückgabecode | Beschreibung |
|---|---|
|
Parameter nIdSelect- ist nicht die lokale ID eines Teils bei einer Auswahlausgabe. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Eine lokale ID ist eine Zahl, die einen Teil zwischen allen Teilen in einer Gerätetopologie eindeutig identifiziert. Rufen Sie zum Abrufen der lokalen ID eines Teils die IPart::GetLocalId- Methode für das Partobjekt auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | devicetopology.h |