IWMDMOperation::BeginWrite-Methode (mswmdm.h)

Artikel
03/04/2024

Die BeginWrite-Methode gibt an, dass eine Aktion "Schreiben auf Gerät" beginnt. Windows Media Geräte-Manager diese Methode nur aufrufen, wenn die Anwendung IWMDMStorageControl/2/3::Insert/2/3 aufruft und diese Schnittstelle übergibt.

Syntax

HRESULT BeginWrite();

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Der Lesevorgang sollte fortgesetzt werden.
WMDM_E_USER_CANCELLED	Der Lesevorgang sollte ohne Abschluss abgebrochen werden.
E_FAIL	Ein nicht angegebener Fehler ist aufgetreten, und der Lesevorgang sollte abgebrochen werden, ohne abgeschlossen zu sein.

Hinweise

Diese Methode wird aufgerufen, bevor die Windows Media-Geräte-Manager IWMDMOperation::TransferObjectData aufruft, um mit dem Schreiben von Daten auf das Gerät zu beginnen.

Beispiele

Das folgende C++-Codebeispiel implementiert die BeginWrite-Methode und gibt eine Nachricht aus, wenn eine Schreibaktion beginnt.


HRESULT BeginWrite()
{
    // TODO: Display the message: "IWMDMOperation event--BeginWrite."
    
    // If the global handle of the destination file is uninitialized, fail.
    if (m_File == INVALID_HANDLE_VALUE)
        return E_FAIL;

    // Global status to let TransferObjectData know what kind of
    // operation is happening.
    m_OperationStatus = OPERATION_WRITE;
    return S_OK;
}