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

Article
02/29/2024

Windows Media Gestionnaire de périphériques appelle GetObjectTotalSize avant qu’un fichier soit écrit sur l’appareil afin de récupérer la taille totale de l’objet, en octets.

Syntaxe

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

Paramètres

[out] pdwSize

Pointeur vers un DWORD qui, au retour, spécifie les bits d’ordre inférieur de la taille de l’objet en octets.

[out] pdwSizeHigh

Pointeur vers un DWORD qui, au retour, spécifie les bits d’ordre élevé de la taille de l’objet en octets.

Valeur retournée

L’application doit retourner l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	L’opération de lecture doit continuer.
WMDM_E_USER_CANCELLED	L’opération de lecture doit être annulée sans se terminer.
E_FAIL	Une erreur non spécifiée s’est produite et l’opération de lecture doit être annulée sans se terminer.

Remarques

Cette méthode est appelée après l’appel de la méthode GetObjectAttributes . Lors du transfert, l’objet qui implémente cette interface reçoit la taille totale du contenu envoyé.

Exemples

Le code C++ suivant implémente GetObjectTotalSize. Il utilise la fonction Win32 GetFileInformationByHandle pour récupérer la taille du fichier sur le point d’être écrit sur l’appareil (m_File) et retourne les valeurs.


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