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

Artigo
03/13/2024

O método GetObjectAttributes permite que o aplicativo especifique atributos para um objeto que está sendo gravado em um dispositivo. O Windows Media Gerenciador de Dispositivos chama esse método antes que um arquivo seja gravado no dispositivo para aprender os atributos do arquivo.

Sintaxe

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

Parâmetros

[out] pdwAttributes

Ponteiro para um DWORD que especifica os atributos definidos no método IWMDMStorage::GetAttributes .

[out] pFormat

Ponteiro para uma estrutura _WAVEFORMATEX que especifica o formato de áudio para arquivos com atributos de dados de áudio.

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 término.
E_FAIL	Ocorreu um erro não especificado e a operação de leitura deve ser cancelada sem término.

Comentários

Ao transferir dados para o dispositivo, você deve fornecer atributos de objeto para a transferência ideal.

Exemplos

O código C++ a seguir implementa o método GetObjectAttributes . Ele tenta determinar se o arquivo que está sendo lido (m_File) é um arquivo ou pasta e define os atributos retornados adequadamente.


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