IWMDMOperation::GetObjectAttributes
.gif) |
The GetObjectAttributes method retrieves the content attributes. Audio attributes include the number of samples per second, the number of bytes per sample, and so on.
Syntax
HRESULT GetObjectAttributes(
DWORD* pdwAttributes,
_WAVEFORMATEX* pFormat
);
Parameters
pdwAttributes
[out] Pointer to a DWORD that, on return, contains the attributes as defined in the IWMDMStorage::GetAttributes method.
pFormat
[out] Pointer to a _WAVEFORMATEX structure that, on return, contains the format for files with audio data attributes.
Return Values
The method returns an HRESULT. All the interface methods in Windows Media Device Manager and service provider can return any of the following classes of error codes:
- Standard COM error codes
- Windows error codes converted to HRESULT values
- Windows Media Device Manager error codes
For a complete list of possible error codes, see Error Codes.
Possible values include, but are not limited to, those in the following table.
| Return code | Description |
| S_OK | The method succeeded. |
| 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 the GetObjectName method.
When transferring data to storage, you must provide attributes for the object. If the stream is audio data, the _WAVEFORMATEX structure to which pFormat points must be filled. If the object is not audio data, then the pFormat parameter can be ignored.
If either E_FAIL or WMDM_E_USER_CANCELLED is returned from this call, the operation is cancelled 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.
Requirements
Header: Defined in wmdm.idl.
Library: mssachlp.lib
See Also