IWMDMOperation::BeginRead-Methode (mswmdm.h)

Die BeginRead-Methode gibt an, dass eine Aktion "Vom Gerät lesen" beginnt. Windows Media Geräte-Manager ruft diese Methode nur auf, wenn die Anwendung IWMDMStorageControl::Read aufruft und diese IWMDMOperation-Schnittstelle übergibt.

Syntax

HRESULT BeginRead();

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.

Beispiele

Im folgenden C++-Codebeispiel wird die BeginRead-Methode implementiert und eine Nachricht ausgegeben, wenn eine Leseaktion vom Gerät beginnt.

HRESULT BeginRead()
{
    // TODO: Display the message: "IWMDMOperation event--BeginRead."

    // If the global handle of the source 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_READ;
    return S_OK;
}

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	mswmdm.h
Bibliothek	Mssachlp.lib

Weitere Informationen

Manuelles Behandeln von Dateiübertragungen

IWMDMOperation-Schnittstelle

IWMDMOperation::BeginWrite