IWMDMOperation::GetObjectTotalSize-Methode (mswmdm.h)

Artikel
03/13/2024

Windows Media Geräte-Manager ruft GetObjectTotalSize auf, bevor eine Datei auf das Gerät geschrieben wird, um die Gesamtgröße des Objekts in Bytes abzurufen.

Syntax

HRESULT GetObjectTotalSize(
  [out] DWORD *pdwSize,
  [out] DWORD *pdwSizeHigh
);

Parameter

[out] pdwSize

Zeiger auf ein DWORD , das bei der Rückgabe die Bits in niedriger Reihenfolge der Objektgröße in Byte angibt.

[out] pdwSizeHigh

Zeiger auf ein DWORD , das bei der Rückgabe die hohen Bits der Objektgröße in Byte angibt.

Rückgabewert

Die Anwendung sollte einen der folgenden HRESULT-Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Lesevorgang sollte fortgesetzt werden.
WMDM_E_USER_CANCELLED	Der Lesevorgang sollte ohne Abschluss abgebrochen werden.
E_FAIL	Ein nicht angegebener Fehler ist aufgetreten, und der Lesevorgang sollte abgebrochen werden, ohne abgeschlossen zu sein.

Hinweise

Diese Methode wird aufgerufen, nachdem die GetObjectAttributes-Methode aufgerufen wurde. Bei der Übertragung wird dem Objekt, das diese Schnittstelle implementiert, die Gesamtgröße des gesendeten Inhalts übergeben.

Beispiele

Der folgende C++-Code implementiert GetObjectTotalSize. Es verwendet die Win32-Funktion GetFileInformationByHandle, um die Dateigröße der Datei abzurufen, die auf das Gerät geschrieben werden soll (m_File), und gibt die Werte zurück.


// About to start writing to the device.
HRESULT GetObjectTotalSize(DWORD*  pdwSize,    DWORD*  pdwSizeHigh)
{
    BY_HANDLE_FILE_INFORMATION fileInfo;
    GetFileInformationByHandle(
        m_File,
        &fileInfo);

    *pdwSize = fileInfo.nFileSizeLow;
    *pdwSizeHigh = fileInfo.nFileSizeHigh;
    // TODO: Display the message: "IWMDMOperation event--GetObjectTotalSize."
    return S_OK;
}