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

Artigo
03/05/2024

O método BeginRead indica que uma ação de "leitura do dispositivo" está começando. O Windows Media Gerenciador de Dispositivos chamará esse método somente se o aplicativo chamar IWMDMStorageControl::Read e passar essa interface IWMDMOperation.

Sintaxe

HRESULT BeginRead();

Retornar valor

O aplicativo deve retornar um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	A operação de leitura deve continuar.
WMDM_E_USER_CANCELLED	A operação de leitura deve ser cancelada sem concluir.
E_FAIL	Ocorreu um erro não especificado e a operação de leitura deve ser cancelada sem concluir.

Comentários

Esse método é chamado pouco antes da Gerenciador de Dispositivos do Windows Media chamar IWMDMOperation::TransferObjectData.

Exemplos

O exemplo de código C++ a seguir implementa o método BeginRead e gera uma mensagem quando uma ação de leitura do dispositivo está começando.


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