Método IWMDMOperation::BeginRead (mswmdm.h)

Artículo
02/29/2024

El método BeginRead indica que se está iniciando una acción de "lectura del dispositivo". Windows Media Administrador de dispositivos solo llama a este método si la aplicación llama a IWMDMStorageControl::Read y pasa esta interfaz IWMDMOperation.

Sintaxis

HRESULT BeginRead();

Valor devuelto

La aplicación debe devolver uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	La operación de lectura debe continuar.
WMDM_E_USER_CANCELLED	La operación de lectura debe cancelarse sin finalizar.
E_FAIL	Se ha producido un error no especificado y la operación de lectura debe cancelarse sin finalizar.

Comentarios

Se llama a este método justo antes de que windows Media Administrador de dispositivos llame a IWMDMOperation::TransferObjectData.

Ejemplos

El siguiente ejemplo de código de C++ implementa el método BeginRead y genera un mensaje cuando se inicia una acción de lectura desde dispositivo.


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;
}