Freigeben über

IMDSPStorageGlobals::GetTotalFree-Methode (mswmdm.h)

  • Artikel

Die GetTotalFree-Methode ruft den gesamten freien Speicherplatz auf dem Speichermedium in Bytes ab.

Syntax

HRESULT GetTotalFree(
  [out] DWORD *pdwFreeLow,
  [out] DWORD *pdwFreeHigh
);

Parameter

[out] pdwFreeLow

Zeiger auf ein DWORD , das die Bytes in niedriger Reihenfolge des freien Speicherplatzes enthält.

[out] pdwFreeHigh

Zeiger auf einen DWORD-Wert , der die bytes der hohen Reihenfolge des freien Speicherplatzes enthält.

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:

  • Com-Standardfehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Um den Speicherplatz zu bestimmen, der vom Medium für die Dateiverwaltung verwendet wird, subtrahieren Sie die Anzahl der fehlerhaften Bytes, die mithilfe von GetTotalBad identifiziert wurden, von der Anzahl der freien Bytes, die mithilfe von GetTotalFree identifiziert wurden.

Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgegeben werden. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPStorageGlobals-Schnittstelle

IMDSPStorageGlobals::GetTotalSize