Windows Media Format SDK banner art
PreviousNext

IWMDMOperation::SetObjectAttributes

The SetObjectAttributes method assigns the content attributes. Audio attributes include the number of samples per second, the number of bytes per sample, and so on.

Syntax

HRESULT SetObjectAttributes(
  DWORD  dwAttributes,
  _WAVEFORMATEX*  pFormat
);

Parameters

  dwAttributes

[in]  Double word containing the object attributes.

  pFormat

[in]  Pointer to a _WAVEFORMATEX structure containing the format for files with audio data attributes.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Description
WMDM_E_USER_CANCELLED The application instructs Windows Media Device Manager to cancel the current operation without waiting for it to finish.
E_FAIL An unspecified error occurred.

Remarks

This method is called after SetObjectName.

For transferring data from storage, you are passed the attributes of the object being written. If the attributes describe audio data, the pwfFormat structure is filled.

If either E_FAIL or WMDM_E_USER_CANCELLED is returned from this call, the operation is terminated and the End method is called. If the application is using block mode and returns WMDM_E_USER_CANCELLED, then Windows Media Device Manager will return this same error to the application.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.