IAudioInputSelector::SetSelection-Methode (devicetopology.h)

Die SetSelection-Methode wählt einen der Eingaben des Eingabeselektors aus.

Syntax

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

Parameter

[in] nIdSelect

Die neue Selektoreingabe. Der Aufrufer sollte diesen Parameter auf die lokale ID eines Teils festlegen, das eine direkte Verbindung zu einem der Selektoreingaben aufweist.

[in] pguidEventContext

Kontextwert für die IControlChangeNotify::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetSelection-Aufruf den Zustand des Eingabeauswahlsteuerelements ä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 bei einer Selektoreingabe.
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.

Ein Codebeispiel, das die SetSelection-Methode aufruft, finden Sie in der Implementierung der SelectCaptureDevice-Funktion in Gerätetopologien.

Anforderungen

Anforderung Wert
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

IAudioInputSelector-Schnittstelle

IPart::GetLocalId