Metodo IWMDMProgress3::End3 (mswmdm.h)

Articolo
03/05/2024

Il metodo End3 viene chiamato da Windows Media Gestione dispositivi per indicare che un'operazione è stata completata. Questo metodo estende IWMDMProgress2::End2 fornendo parametri di input aggiuntivi per l'identificazione (ID) dell'evento e per un puntatore al contesto dei comandi.

Sintassi

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

Parametri

[in] EventId

GUID che specifica l'evento che termina. 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, i dati specificano 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] hrCompletionCode

HRESULT che specifica il codice di completamento dell'operazione in corso. Il parametro hrCompletionCode è il codice restituito dell'operazione terminata. Questo parametro può essere qualsiasi HRESULT, inclusi i codici di errore COM standard, i codici di errore Win32 convertiti in HRESULT o Windows Media Gestione dispositivi codici di errore.

[in, out] pContext

Puntatore a una struttura OPAQUECOMMAND contenente un comando inviato direttamente al dispositivo senza essere gestito da Windows Media Gestione dispositivi. Questo parametro è facoltativo e può essere NULL. La struttura del contesto è un modo per consentire al componente di inviare tutti i dati pertinenti con l'evento all'applicazione. Il componente che invia questa struttura deve definire come l'applicazione può interpretare questa struttura di dati.

Valore restituito

Windows Media Gestione dispositivi ignora qualsiasi codice restituito dal metodo End3 perché l'operazione corrente viene completata o annullata prima della chiamata di questo metodo.

Commenti

L'interfaccia proprietaria del metodo che implementa un'operazione chiama End3 al termine dell'operazione definita dal metodo .

Esempio

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


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}