IAudioOutputSelector::SetSelection-Methode (devicetopology.h)

Die SetSelection-Methode wählt eine der Ausgaben des Ausgabeselektors aus.

Syntax

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] nIdSelect

Die neue Selektorausgabe. Der Aufrufer sollte diesen Parameter auf die lokale ID eines Teils festlegen, das eine direkte Verbindung zu einer der Selektorausgaben aufweist.

[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, 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
E_INVALIDARG	Parameter nIdSelect ist nicht die lokale ID eines Teils an einer Selektorausgabe.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Eine lokale ID ist eine Zahl, die einen Teil unter allen Teilen einer Gerätetopologie eindeutig identifiziert. Um die lokale ID eines Teils abzurufen, rufen Sie die IPart::GetLocalId-Methode für das Teilobjekt auf.

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

Weitere Informationen

IAudioOutputSelector-Schnittstelle

IPart::GetLocalId