Metodo IWMDMProgress3::Begin3 (mswmdm.h)

Articolo
08/25/2023

Il metodo Begin3 viene chiamato da Windows Media Gestione dispositivi per indicare che un'operazione sta per iniziare. Quando possibile, viene fornita una stima della durata dell'operazione. Questo metodo estende IWMDMProgress::Begin fornendo parametri di input aggiuntivi per l'identificazione (ID) dell'evento e per un puntatore al contesto facoltativo dei comandi. L'operazione viene identificata da un ID evento. Il metodo consente al chiamante di passare una struttura di dati opaca all'applicazione.

Sintassi

HRESULT Begin3(
  [in]      GUID          EventId,
  [in]      DWORD         dwEstimatedTicks,
  [in, out] OPAQUECOMMAND *pContext
);

Parametri

[in] EventId

GUID che identifica l'operazione che inizierà. Nella tabella seguente vengono illustrati i valori possibili.

Event	Descrizione
SCP_EVENTID_ACQSECURECLOCK	Windows Media Gestione dispositivi acquisisce un orologio sicuro dal server.
SCP_EVENTID_NEEDTOINDIV	Il dispositivo viene individualizzato. Questa operazione non è attualmente utilizzata.
SCP_EVENTID_DRMINFO	Questo ID evento viene usato per notificare all'applicazione l'intestazione DRM della versione trovata nel contenuto per ogni file. La struttura OPAQUECOMMAND restituita ha il membro guidCommand impostato su SCP_PARAMID_DRMVERSION. Inoltre, OPACOCOMMAND specifica uno dei flag seguenti: WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	Il contenuto viene trasferito da o verso il dispositivo.

[in] dwEstimatedTicks

DWORD che specifica il numero stimato di tick necessari per il completamento dell'operazione. Il numero di tick passati in dwEstimatedTicks è una stima del numero di tick necessari per il completamento dell'operazione. Durante il corso dell'operazione, viene chiamato il metodo Progress3 per indicare il numero di tick che si sono verificati. Le applicazioni possono usare la stima per configurare i meccanismi di visualizzazione che mostrano lo stato di avanzamento.

[in, out] pContext

Puntatore a una struttura OPAQUECOMMAND contenente un comando inviato al dispositivo senza essere gestito da Windows Media Gestione dispositivi. Questo parametro è facoltativo e può essere NULL.

Valore restituito

L'applicazione deve restituire uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	L'operazione deve continuare.
WMDM_E_USER_CANCELLED	Windows Media Gestione dispositivi deve annullare l'operazione corrente senza attendere il completamento. Se l'applicazione usa la modalità blocco, Windows Media Gestione dispositivi restituirà questo errore all'applicazione.

Commenti

L'applicazione restituisce S_OK per indicare che un'operazione deve essere continuata e WMDM_E_USER_CANCELLED per indicare che l'operazione deve essere annullata. Se l'applicazione usa la modalità blocco e restituisce WMDM_E_USER_CANCELLED, Windows Media Gestione dispositivi restituirà lo stesso errore all'applicazione.

Esempio

Il codice C++ seguente illustra un'implementazione di esempio di Begin3.


HRESULT Begin3(GUID  EventId, DWORD  dwEstimatedTicks, OPAQUECOMMAND*  pContext)
{
    WCHAR strGuid[64];
    StringFromGUID2(reinterpret_cast<GUID&>(EventId),(LPOLESTR)strGuid, 64);
    // TODO: Display the message "IWMDMProgress3::Begin3 called." 
    // followed by the strGuid value.
    return S_OK;
}