IMDServiceProvider3::SetDeviceEnumPreference-Methode (mswmdm.h)
Die SetDeviceEnumPreference-Methode legt die Geräteenumerationseinstellungen fest.
Syntax
HRESULT SetDeviceEnumPreference(
[in] DWORD dwEnumPref
);
Parameter
[in] dwEnumPref
Enthält eine bitweise OR-Kombination aus einem oder mehreren der folgenden Bitwerte, die die Enumerationspräferenz angeben. Jedes festgelegte Bit aktiviert das entsprechende erweiterte Verhalten, während das Fehlen dieses Bits das erweiterte Verhalten deaktiviert und das standardmäßige abwärtskompatible Enumerationsverhalten angibt. Die möglichen Werte für dwEnumPref werden in der folgenden Tabelle angegeben.
| Wert | BESCHREIBUNG |
|---|---|
| DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES | Bei Geräten, die mehrere Speichermedien enthalten, zählt jeder dieser Speicher standardmäßig als separates Pseudogerät auf. Wenn dieses Bit jedoch festgelegt ist, sind Speicher nicht als Geräte sichtbar, und nur Geräte sind als Geräte sichtbar. |
| ALLOW_OUTOFBAND_NOTIFICATION | Standardmäßig stellt der IWMDMNotification-Rückrufmechanismus Anwendungen Gerätean- und -entfernungsereignisse bereit. Wenn dieses Bit festgelegt ist, kann der Dienstanbieter die Anwendung über einen separaten Mechanismus benachrichtigen, z. B. mithilfe einer Fenstermeldung. Dieses Verhalten wird zusätzlich zu den Windows Media-Geräte-Manager-Benachrichtigungen verwendet. Dieses Flag unterdrückt keine Windows Media-Geräte-Manager benachrichtigungen. |
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der dwEnumPref-Parameter enthält einen nicht unterstützten Bitwert. |
|
Die -Methode wurde nach einem Enumerationsvorgang aufgerufen. Sie muss vor dem Enumerationsvorgang aufgerufen werden. |
Hinweise
Diese API bietet Clients die Möglichkeit, das Standardverhalten der Geräteenumeration von Windows Media Geräte-Manager außer Kraft zu setzen.
Clientanwendungen müssen diese Methode unmittelbar nach dem Erstellen des Geräte-Manager-Objekts aufrufen, indem sie die IWMDeviceManager-Schnittstelle von Windows Media Geräte-Manager abfragen. Der Aufruf muss vor einer Enumeration erfolgen, entweder explizit oder implizit als Ergebnis eines anderen Vorgangs.
Nachdem ein Einstellungsflag festgelegt wurde, kann es für die Lebensdauer der Anwendung nicht mehr geändert werden (nicht nur die Lebensdauer des Windows Media-Geräte-Manager-Objekts). Der Versuch, ein Einstellungsflag zu ändern, führt zu einem Fehler. Das erneute Aufrufen dieser API mit denselben Flageinstellungen gibt keinen Fehler zurück und wirkt sich auch auf die Enumeration aus.
Das DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES Flag muss vom Dienstanbieter berücksichtigt werden, um wirksam zu werden. Es ist möglich, dass trotz dieses Flags einige Geräte als Gerät pro Speicher aufgezählt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |