IWMDMProgress3::End3-Methode (mswmdm.h)

Artikel
02/29/2024

Die End3-Methode wird von Windows Media Geräte-Manager aufgerufen, um anzugeben, dass ein Vorgang abgeschlossen wurde. Diese Methode erweitert IWMDMProgress2::End2 , indem zusätzliche Eingabeparameter für die Identifikation (ID) des Ereignisses und für einen Zeiger auf den Kontext der Befehle bereitgestellt werden.

Syntax

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

Parameter

[in] EventId

Eine GUID , die das endende Ereignis angibt. Mögliche Werte werden in der folgenden Tabelle angezeigt.

Ereignis	BESCHREIBUNG
SCP_EVENTID_ACQSECURECLOCK	Windows Media Geräte-Manager erhält eine sichere Uhr vom Server.
SCP_EVENTID_NEEDTOINDIV	Das Gerät wird individualisiert. Dies wird derzeit nicht verwendet.
SCP_EVENTID_DRMINFO	Diese Ereignis-ID wird verwendet, um die Anwendung mit dem DRM-Header der Version zu benachrichtigen, der sich im Inhalt für jede Datei befindet. Für die zurückgegebene OPAQUECOMMAND-Struktur ist das element guidCommand auf SCP_PARAMID_DRMVERSION festgelegt. Darüber hinaus geben die Daten eines der folgenden Flags an: WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	Der Inhalt wird auf das oder vom Gerät übertragen.

[in] hrCompletionCode

HRESULT , das den Vervollständigungscode des laufenden Vorgangs angibt. Der hrCompletionCode-Parameter ist der Rückgabecode des vorgangs, der beendet wurde. Bei diesem Parameter kann es sich um ein beliebiges HRESULT handeln, einschließlich standardmäßiger COM-Fehlercodes, in HRESULT konvertierter Win32-Fehlercodes oder Windows Media Geräte-Manager Fehlercodes.

[in, out] pContext

Zeiger auf eine OPAQUECOMMAND-Struktur, die einen Befehl enthält, der direkt an das Gerät gesendet wird, ohne von Windows Media Geräte-Manager behandelt zu werden. Dieser Parameter ist optional und kann NULL sein. Die Kontextstruktur ist eine Möglichkeit für die Komponente, alle relevanten Daten mit dem Ereignis an die Anwendung zu senden. Die Komponente, die diese Struktur sendet, sollte definieren, wie die Anwendung diese Datenstruktur interpretieren kann.

Rückgabewert

Windows Media Geräte-Manager ignoriert jeglichen Rückgabecode, der von der End3-Methode zurückgegeben wird, da der aktuelle Vorgang abgeschlossen oder abgebrochen wird, bevor diese Methode aufgerufen wird.

Hinweise

Die Schnittstelle, die die Methode besitzt, die einen Vorgang implementiert, ruft End3 auf, wenn der von der -Methode definierte Vorgang abgeschlossen ist.

Beispiele

Der folgende C++-Code zeigt eine Beispielimplementierung von End3.


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