Metodo IMDSPStorageGlobals::Initialize (mswmdm.h)

Articolo
02/29/2024

Il metodo Initialize formatta il supporto di archiviazione. È facoltativo. Tuttavia, questo metodo deve essere implementato se il dispositivo supporta questa funzionalità. Se questo metodo non è implementato, IMDSPStorageGlobals::GetCapabilities deve restituire WMDM_STORAGECAP_NOT_INITIALIZABLE oltre a qualsiasi altro flag. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.

Sintassi

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

Parametri

[in] fuMode

Modalità utilizzata per inizializzare il supporto. Specificare esattamente una delle due modalità seguenti. Se vengono specificate entrambe le modalità, viene utilizzata la modalità di blocco.

Mode	Descrizione
WMDM_MODE_BLOCK	L'operazione viene eseguita usando l'elaborazione in modalità blocco. La chiamata non viene restituita fino al termine dell'operazione.
WMDM_MODE_THREAD	L'operazione viene eseguita usando l'elaborazione in modalità thread. La chiamata restituisce immediatamente e l'operazione viene eseguita in un thread in background.

[in] pProgress

Puntatore a un'interfaccia IWMDMProgress implementata da un'applicazione per tenere traccia dello stato di avanzamento dell'operazione di formattazione. Questo parametro può essere NULL.

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Se viene specificato WMDM_MODE_BLOCK, Initialize non restituisce fino al termine della formattazione. Se viene specificato il WMDM_MODE_THREAD, la chiamata restituisce immediatamente e il chiamante può utilizzare il metodo IMDSPStorageGlobals::GetStatus per tenere traccia dell'operazione di inizializzazione.