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 |
|---|---|
|
Der Lesevorgang sollte fortgesetzt werden. |
|
Der Lesevorgang sollte ohne Abschluss abgebrochen werden. |
|
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 |