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 |
|---|---|
|
Parameter nIdSelect ist nicht die lokale ID eines Teils bei einer Selektoreingabe. |
|
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 |