IWMDMProgress3::Begin3-Methode (mswmdm.h)

Artikel
03/04/2024

Die Begin3-Methode wird von Windows Media Geräte-Manager aufgerufen, um anzugeben, dass ein Vorgang gerade beginnt. Eine Schätzung der Dauer des Vorgangs wird nach Möglichkeit bereitgestellt. Diese Methode erweitert IWMDMProgress::Begin , indem zusätzliche Eingabeparameter für die Identifizierung (ID) des Ereignisses und für einen Zeiger auf den optionalen Kontext der Befehle bereitgestellt werden. Der Vorgang wird durch eine Ereignis-ID identifiziert. Die -Methode ermöglicht es dem Aufrufer, eine undurchsichtige Datenstruktur an die Anwendung zu übergeben.

Syntax

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

Parameter

[in] EventId

Eine GUID , die den zu beginnden Vorgang identifiziert. 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-Versionsheader zu benachrichtigen, der sich im Inhalt für jede Datei befindet. Für die zurückgegebene OPAQUECOMMAND-Struktur ist das guidCommand-Element auf SCP_PARAMID_DRMVERSION festgelegt. Darüber hinaus gibt der OPAQUECOMMAND eines der folgenden Flags an: WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	Inhalte werden an oder vom Gerät übertragen.

[in] dwEstimatedTicks

DWORD , die die geschätzte Anzahl von Ticks angibt, die für den Abschluss des Vorgangs erforderlich sind. Die Anzahl der in dwEstimatedTicks übergebenen Ticks ist eine Schätzung, wie viele Ticks für den Abschluss des Vorgangs benötigt werden. Während des Vorgangs wird die Progress3-Methode aufgerufen, um anzugeben, wie viele Ticks transpiriert wurden. Anwendungen können die Schätzung verwenden, um Anzeigemechanismen zu konfigurieren, die den Fortschritt anzeigen.

[in, out] pContext

Zeiger auf eine OPAQUECOMMAND-Struktur, die einen Befehl enthält, der an das Gerät gesendet wird, ohne von Windows Media Geräte-Manager behandelt zu werden. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Die Anwendung sollte einen der folgenden HRESULT-Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang sollte fortgesetzt werden.
WMDM_E_USER_CANCELLED	Windows Media Geräte-Manager sollte den aktuellen Vorgang abbrechen, ohne auf den Abschluss zu warten. Wenn die Anwendung den Blockmodus verwendet, gibt Windows Media Geräte-Manager diesen Fehler an die Anwendung zurück.

Hinweise

Die Anwendung gibt S_OK zurück, um anzugeben, dass ein Vorgang fortgesetzt werden soll, und WMDM_E_USER_CANCELLED, um anzugeben, dass der Vorgang abgebrochen werden soll. Wenn die Anwendung den Blockmodus verwendet und WMDM_E_USER_CANCELLED zurückgibt, gibt Windows Media Geräte-Manager denselben Fehler an die Anwendung zurück.

Beispiele

Der folgende C++-Code zeigt eine Beispielimplementierung von 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;
}