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

Article
02/29/2024

La méthode GetObjectAttributes permet à l’application de spécifier des attributs pour un objet en cours d’écriture sur un appareil. Windows Media Gestionnaire de périphériques appelle cette méthode avant qu’un fichier ne soit écrit sur l’appareil afin d’apprendre les attributs du fichier.

Syntaxe

HRESULT GetObjectAttributes(
  [out] DWORD         *pdwAttributes,
  [out] _WAVEFORMATEX *pFormat
);

Paramètres

[out] pdwAttributes

Pointeur vers un DWORD qui spécifie les attributs définis dans la méthode IWMDMStorage ::GetAttributes .

[out] pFormat

Pointeur vers une structure de _WAVEFORMATEX qui spécifie le format audio des fichiers avec des attributs de données audio.

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

Lors du transfert de données vers l’appareil, vous devez fournir des attributs d’objet pour un transfert optimal.

Exemples

Le code C++ suivant implémente la méthode GetObjectAttributes . Il tente de déterminer si le fichier en cours de lecture (m_File) est un fichier ou un dossier et de définir les attributs retournés en conséquence.


HRESULT GetObjectAttributes(DWORD* pdwAttributes, _WAVEFORMATEX* pFormat)
{
    // TODO: Display the message: IWMDMOperation event--GetObjectAttributes.
    *pdwAttributes = WMDM_FILE_ATTR_FILE | 
        WMDM_STORAGE_ATTR_REMOVABLE | 
        WMDM_FILE_ATTR_AUDIO;

    BY_HANDLE_FILE_INFORMATION fileInformation;
    if (GetFileInformationByHandle(m_File, &fileInformation))
    {
        if (fileInformation.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)
            *pdwAttributes |= WMDM_FILE_ATTR_FOLDER;
        else
            *pdwAttributes |= WMDM_FILE_ATTR_FILE;

        if (fileInformation.dwFileAttributes & FILE_ATTRIBUTE_READONLY)
            *pdwAttributes |= FILE_ATTRIBUTE_READONLY;
    }

    return S_OK;
}