Metodo IWMDMOperation::GetObjectAttributes (mswmdm.h)

Articolo
03/15/2023

Il metodo GetObjectAttributes consente all'applicazione di specificare gli attributi per un oggetto scritto in un dispositivo. Windows Media Gestione dispositivi chiama questo metodo prima che un file venga scritto nel dispositivo per apprendere gli attributi del file.

Sintassi

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

Parametri

[out] pdwAttributes

Puntatore a un DWORD che specifica gli attributi definiti nel metodo IWMDMStorage::GetAttributes .

[out] pFormat

Puntatore a una struttura _WAVEFORMATEX che specifica il formato audio per i file con attributi di dati audio.

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 terminare.
E_FAIL	Si è verificato un errore non specificato e l'operazione di lettura deve essere annullata senza terminare.

Commenti

Quando si trasferiscono dati nel dispositivo, è necessario fornire attributi oggetto per un trasferimento ottimale.

Esempio

Il codice C++ seguente implementa il metodo GetObjectAttributes . Tenta di determinare se il file letto (m_File) è un file o una cartella e imposta gli attributi restituiti di conseguenza.


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