Метод IMDSPStorageGlobals::Initialize (mswmdm.h)

Статья
08/25/2023

Метод Initialize форматирует носитель хранилища. Этот метод является необязательным. Однако этот метод следует реализовать, если устройство поддерживает эту функцию. Если этот метод не реализован, IMDSPStorageGlobals::GetCapabilities должен возвращать WMDM_STORAGECAP_NOT_INITIALIZABLE в дополнение к любым другим флагам. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Синтаксис

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

Параметры

[in] fuMode

Режим, используемый для инициализации среды. Укажите один из следующих двух режимов. Если указаны оба режима, используется блочный режим.

Режим	Описание
WMDM_MODE_BLOCK	Операция выполняется с помощью обработки в блочном режиме. Вызов не возвращается, пока операция не будет завершена.
WMDM_MODE_THREAD	Операция выполняется с помощью обработки в режиме потока. Вызов возвращается немедленно, и операция выполняется в фоновом потоке.

[in] pProgress

Указатель на интерфейс IWMDMProgress , реализованный приложением для отслеживания хода выполнения операции форматирования. Этот параметр может принимать значение NULL.

Возвращаемое значение

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

Стандартные коды ошибок COM
Коды ошибок Windows, преобразованные в значения HRESULT
Коды ошибок диспетчер устройств Windows Media

Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Если указано WMDM_MODE_BLOCK, функция Initialize не возвращается, пока форматирование не будет завершено. Если указан WMDM_MODE_THREAD, вызов возвращается немедленно, и вызывающий объект может использовать метод IMDSPStorageGlobals::GetStatus для отслеживания операции инициализации.