IMDSPStorageGlobals::Initialize method (mswmdm.h)

The Initialize method formats the storage medium. This method is optional. However, this method should be implemented if the device supports this functionality. If this method is not implemented, IMDSPStorageGlobals::GetCapabilities must return WMDM_STORAGECAP_NOT_INITIALIZABLE in addition to any other flags. For more information, see Mandatory and Optional Interfaces.

Syntax

HRESULT Initialize(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

Parameters

[in] fuMode

Mode used to initialize the medium. Specify exactly one of the following two modes. If both modes are specified, block mode is used.

[in] pProgress

Pointer to an IWMDMProgress interface implemented by an application to track the progress of the formatting operation. This parameter can be NULL.

Return value

The method returns an HRESULT. All the interface methods in Windows Media Device Manager 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

Remarks

If WMDM_MODE_BLOCK is specified, Initialize does not return until formatting is finished. If the WMDM_MODE_THREAD is specified, the call returns immediately and the caller can use the IMDSPStorageGlobals::GetStatus method to track the initializing operation.

Requirements

See also

IMDSPStorageGlobals Interface

IMDSPStorageGlobals::GetCapabilities

IMDSPStorageGlobals::GetStatus

IWMDMProgress Interface