Método IWMDMOperation::GetObjectTotalSize (mswmdm.h)

Artigo
03/05/2024

O Windows Media Gerenciador de Dispositivos chama GetObjectTotalSize antes que um arquivo seja gravado no dispositivo para recuperar o tamanho total do objeto, em bytes.

Sintaxe

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

Parâmetros

[out] pdwSize

Ponteiro para um DWORD que, no retorno, especifica os bits de ordem inferior do tamanho do objeto em bytes.

[out] pdwSizeHigh

Ponteiro para um DWORD que, no retorno, especifica os bits de alta ordem do tamanho do objeto em bytes.

Retornar valor

O aplicativo deve retornar um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	A operação de leitura deve continuar.
WMDM_E_USER_CANCELLED	A operação de leitura deve ser cancelada sem concluir.
E_FAIL	Ocorreu um erro não especificado e a operação de leitura deve ser cancelada sem concluir.

Comentários

Esse método é chamado depois que o método GetObjectAttributes é chamado. Ao transferir, o objeto que implementa essa interface recebe o tamanho total do conteúdo que está sendo enviado.

Exemplos

O código C++ a seguir implementa GetObjectTotalSize. Ele usa a função Win32 GetFileInformationByHandle para recuperar o tamanho do arquivo prestes a ser gravado no dispositivo (m_File) e retorna os valores.


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