Interface IHostTaskManager

Artigo
08/25/2010

Fornece métodos que permitem a Common linguagem tempo de execução (CLR) para trabalhar com tarefas através do host em vez de usar as funções de segmentação ou fibra de padrão do sistema operacional.

interface IHostTaskManager : IUnknown
{
    HRESULT GetCurrentTask (
                [out] IHostTask **pTask
        );

    HRESULT CreateTask (
                [in] DWORD dwStackSize,
        [in] LPTHREAD_START_ROUTINE pStartAddress,
        [in] PVOID pParameter,
        [out] IHostTask **ppTask
        );

    HRESULT Sleep (
                [in] DWORD dwMilliseconds,
        [in] DWORD option
        );

    HRESULT SwitchToTask (
                [in] DWORD option
        );

    HRESULT SetUILocale (
                [in] LCID lcid
        );

    HRESULT SetLocale (
                [in] LCID lcid
        );

    HRESULT CallNeedsHostHook (
                [in] SIZE_T target,
        [out] BOOL *pbCallNeedsHostHook
        );

    HRESULT LeaveRuntime (
                [in] SIZE_T target
        );

    HRESULT EnterRuntime ();

    HRESULT ReverseLeaveRuntime ();

    HRESULT ReverseEnterRuntime ();

    HRESULT BeginDelayAbort ();

    HRESULT EndDelayAbort ();

    HRESULT BeginThreadAffinity ();

    HRESULT EndThreadAffinity ();

    HRESULT SetStackGuarantee (
                [in] ULONG guarantee
        );

    HRESULT GetStackGuarantee (
                [out] ULONG *pGuarantee
        );

    HRESULT SetCLRTaskManager (
        [in] ICLRTaskManager *ppManager
        );

}

Métodos

Método	Descrição
Método IHostTaskManager::BeginDelayAbort	Notifica o host que o código gerenciado é a inclusão de um ponto em que a tarefa corrente não deve ser anulada.
Método IHostTaskManager::BeginThreadAffinity	Notifica o host que o código gerenciado é a inclusão de um ponto em que a tarefa corrente não deve ser movida para outro thread do sistema operacional.
Método IHostTaskManager::CallNeedsHostHook	Permite que o host para especificar se o Common linguagem tempo de execução pode embutido a telefonar especificada para uma função não gerenciada.
Método IHostTaskManager::CreateTask	Solicitações que o host crie uma nova tarefa.
Método IHostTaskManager::EndDelayAbort	Notifica o host que o código gerenciado está saindo do período em que a tarefa corrente não deve ser interrompida, após uma telefonar anterior ao BeginDelayAbort.
Método IHostTaskManager::EndThreadAffinity	Notifica o host que o código gerenciado está saindo do período em que a tarefa corrente não deve ser movida para outro thread do sistema operacional, após uma telefonar anterior ao BeginThreadAffinity.
Método IHostTaskManager::EnterRuntime	Notifica o host que uma telefonar para um método de não gerenciado, sistema autônomo uma plataforma de invocar o método, está retornando controle de execução para o CLR.
Método IHostTaskManager::GetCurrentTask	Obtém um ponteiro de interface para a tarefa está sendo executado no thread do sistema operacional do qual esta telefonar é feita no momento.
Método IHostTaskManager::GetStackGuarantee	Obtém a quantidade de espaço de pilha é garantido que esteja disponível após a conclusão de uma operação de pilha, mas antes do fechamento de um processo.
Método IHostTaskManager::LeaveRuntime	Notifica o host que o código gerenciado está prestes a fazer uma telefonar para uma função não gerenciada.
Método IHostTaskManager::ReverseEnterRuntime	Notifica o host que está sendo feita uma telefonar para o Common linguagem tempo de execução (CLR) do código não gerenciado.
Método IHostTaskManager::ReverseLeaveRuntime	Notifica o host que o controle está deixando o CLR e inserir uma função não gerenciada foi, por sua vez, chamada a partir de código gerenciado.
Método IHostTaskManager::SetCLRTaskManager	Fornece o host com um ponteiro de interface para um ICLRTaskManager instância implementada pelo CLR.
Método IHostTaskManager::SetLocale	Notifica o host que o CLR alterou a localidade da tarefa corrente.
Método IHostTaskManager::SetStackGuarantee	Reservado para uso interno somente.
Método IHostTaskManager::SetUILocale	Notifica o host que a localidade de interface do usuário foi alterada na tarefa corrente.
Método IHostTaskManager::suspensão	Notifica o host que a tarefa corrente será em suspensão.
Método IHostTaskManager::SwitchToTask	Notifica o host que ele deve comutador a tarefa corrente.

Comentários

IHostTaskManager permite que o CLR criar e gerenciar tarefas, forneça ganchos para o host agir quando transfere o controle do gerenciado para código não gerenciado e vice-versa e para especificar determinadas ações o host pode e não é possível colocar durante a execução do código.