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.

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

Siehe auch

IAudioOutputSelector Interface

IPart::GetLocalId