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

Artigo
03/05/2024

O método BeginWrite indica que uma ação "gravar no dispositivo" está começando. O Windows Media Gerenciador de Dispositivos chamará esse método somente se o aplicativo chamar IWMDMStorageControl/2/3::Insert/2/3 e passar nessa interface.

Sintaxe

HRESULT BeginWrite();

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 para começar a gravar dados no dispositivo.

Exemplos

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


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