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

Artículo
08/25/2023

El método GetObjectAttributes permite a la aplicación especificar atributos para un objeto que se escribe en un dispositivo. Windows Media Administrador de dispositivos llama a este método antes de escribir un archivo en el dispositivo para aprender los atributos del archivo.

Sintaxis

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

Parámetros

[out] pdwAttributes

Puntero a un DWORD que especifica los atributos definidos en el método IWMDMStorage::GetAttributes .

[out] pFormat

Puntero a una estructura de _WAVEFORMATEX que especifica el formato de audio para los archivos con atributos de datos de audio.

Valor devuelto

La aplicación debe devolver uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	La operación de lectura debe continuar.
WMDM_E_USER_CANCELLED	La operación de lectura debe cancelarse sin finalizar.
E_FAIL	Se ha producido un error no especificado y la operación de lectura debe cancelarse sin finalizar.

Comentarios

Al transferir datos al dispositivo, debe proporcionar atributos de objeto para una transferencia óptima.

Ejemplos

El siguiente código de C++ implementa el método GetObjectAttributes . Intenta determinar si el archivo que se lee (m_File) es un archivo o carpeta y establece los atributos devueltos en consecuencia.


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