IMDSPStorageGlobals::GetCapabilities-Methode (mswmdm.h)
Die GetCapabilities-Methode ruft die Funktionen des Speichermediums ab, dem ein instance dieser Schnittstelle zugeordnet ist.
Syntax
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilities
);
Parameter
[out] pdwCapabilities
Zeiger auf ein DWORD , das die Funktionen des Speichermediums enthält.
Die folgenden Flags können im pdwCapabilities-Parameter zurückgegeben werden.
| Flag | Beschreibung |
|---|---|
| WMDM_STORAGECAP_FOLDERSINROOT | Das Medium unterstützt Ordner im Stammverzeichnis des Speichers. |
| WMDM_STORAGECAP_FILESINROOT | Das Medium unterstützt Dateien im Stammspeicher. |
| WMDM_STORAGECAP_FOLDERSINFOLDERS | Das Medium unterstützt Ordner in Ordnern. |
| WMDM_STORAGECAP_FILESINFOLDERS | Das Medium unterstützt Dateien in Ordnern. |
| WMDM_STORAGECAP_FOLDERLIMITEXISTS | Es gibt eine beliebige Anzahl von Ordnern, die pro Form der Ordnerunterstützung durch das Medium zulässig sind. |
| WMDM_STORAGECAP_FILELIMITEXISTS | Es gibt eine beliebige Anzahl von Dateien, die pro Form der Dateiunterstützung durch das Medium zulässig sind. |
| WMDM_STORAGECAP_NOT_INITIALIZABLE | Das Medium kann nicht initialisiert werden. Standardmäßig kann der Speicher der obersten Ebene initialisiert werden. |
Für geschützte Geräteimplementierungen können auch die folgenden Flags zurückgegeben werden, die die Rechtefunktionen des Mediums beschreiben.
| Flag | Beschreibung |
|---|---|
| WMDM_RIGHTS_PLAYBACKCOUNT | Das Medium unterstützt die Beschränkung der Wiedergabeanzahl für Inhalte. |
| WMDM_RIGHTS_EXPIRATIONDATE | Das Medium unterstützt die Ablaufdatumsnachverfolgung für Inhalte. |
| WMDM_RIGHTS_FREESERIALIDS | Das Medium unterstützt einen kostenlosen seriellen Bezeichner für die Datei. |
| WMDM_RIGHTS_GROUPID | Das Medium unterstützt einen Gruppenbezeichner für die Datei. |
| WMDM_RIGHTS_NAMEDSERIALIDS | Das Medium unterstützt einen benannten seriellen Bezeichner für die Datei. |
Rückgabewert
Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:
- Standard-COM-Fehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Versuche, nicht unterstützte Vorgänge auf dem Speichermedium mit der IMDSPObject-Schnittstelle auszuführen, geben einen Fehlercode zurück. Die GetCapabilities-Methode kann aufgerufen werden, um zu bestimmen, ob ein Vorgang unter normalen Umständen erfolgreich ist.
Wenn entweder das flag WMDM_STORAGECAP_FILELIMITEXISTS oder das WMDM_STORAGECAP_FOLDERLIMITEXISTS flag true ist, gibt es beliebige Grenzwerte für die Anzahl der Dateien oder Ordner, die erstellt werden können. Vorgänge über die IMDSPObject-Schnittstelle , die diese Grenzwerte überschreiten, schlagen fehl.
Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |