Metodo IWMDMOperation::GetObjectTotalSize (mswmdm.h)

Articolo
03/05/2024

Windows Media Gestione dispositivi chiama GetObjectTotalSize prima che un file venga scritto nel dispositivo per recuperare le dimensioni totali dell'oggetto, in byte.

Sintassi

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

Parametri

[out] pdwSize

Puntatore a un DWORD che, in caso di restituzione, specifica i bit a basso ordine delle dimensioni dell'oggetto in byte.

[out] pdwSizeHigh

Puntatore a un DWORD che, in caso di restituzione, specifica i bit di ordine elevato delle dimensioni dell'oggetto in byte.

Valore restituito

L'applicazione deve restituire uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	L'operazione di lettura deve continuare.
WMDM_E_USER_CANCELLED	L'operazione di lettura deve essere annullata senza completare.
E_FAIL	Si è verificato un errore non specificato e l'operazione di lettura deve essere annullata senza terminare.

Commenti

Questo metodo viene chiamato dopo la chiamata del metodo GetObjectAttributes . Quando si trasferisce, l'oggetto che implementa questa interfaccia viene passato alla dimensione totale del contenuto inviato.

Esempio

Il codice C++ seguente implementa GetObjectTotalSize. Usa la funzione Win32 GetFileInformationByHandle per recuperare le dimensioni del file da scrivere nel dispositivo (m_File) e restituisce i valori.


// 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;
}