Obter uma porta
Uma porta representa uma conexão com uma máquina na qual os processos estão sendo executados. Essa máquina pode ser a máquina local ou uma máquina remota (que pode estar executando um sistema operacional não baseado no Windows; consulte Portas para obter mais informações).
Uma porta é representada pela interface IDebugPort2 . Ele é usado para obter informações sobre processos em execução na máquina à qual a porta está conectada.
Um mecanismo de depuração precisa de acesso a uma porta para registrar nós de programa com a porta e satisfazer solicitações de informações de processo. Por exemplo, se o mecanismo de depuração implementa a interface IDebugProgramProvider2, a implementação do método GetProviderProcessData pode solicitar à porta que as informações de processo necessárias sejam retornadas.
O Visual Studio fornece a porta necessária para o mecanismo de depuração e obtém essa porta de um fornecedor de porta. Se um programa estiver conectado (de dentro do depurador ou devido a uma exceção que foi lançada, o que aciona a caixa de diálogo Just-in-Time [JIT]), o usuário terá a opção de transporte (outro nome para um fornecedor de porta) a ser usado. Caso contrário, se o usuário iniciar o programa de dentro do depurador, o sistema de projeto especificará o fornecedor de porta a ser usado. Em ambos os casos, o Visual Studio instancia o fornecedor de porta, representado por uma interface IDebugPortSupplier2, e solicita uma nova porta chamando AddPort com uma interface IDebugPortRequest2. Essa porta é então passada para o mecanismo de depuração de uma forma ou de outra.
Exemplo
Este fragmento de código mostra como usar a porta fornecida a LaunchSuspended para registrar um nó de programa em ResumeProcess. Parâmetros não diretamente relacionados a esse conceito foram omitidos para maior clareza.
Observação
Este exemplo usa a porta para iniciar e retomar o processo e pressupõe que a interface IDebugPortEx2 está implementada na porta. Esta não é de forma alguma a única maneira de executar essas tarefas, e é possível que a porta nem mesmo esteja envolvida além de ter o IDebugProgramNode2 do programa dado a ele.
// This is an IDebugEngineLaunch2 method.
HRESULT CDebugEngine::LaunchSuspended(/* omitted parameters */,
IDebugPort2 *pPort,
/* omitted parameters */,
IDebugProcess2**ppDebugProcess)
{
// do stuff here to set up for a launch (such as handling the other parameters)
...
// Now get the IPortNotify2 interface so we can register a program node
// in CDebugEngine::ResumeProcess.
CComPtr<IDebugDefaultPort2> spDefaultPort;
HRESULT hr = pPort->QueryInterface(&spDefaultPort);
if (SUCCEEDED(hr))
{
CComPtr<IDebugPortNotify2> spPortNotify;
hr = spDefaultPort->GetPortNotify(&spPortNotify);
if (SUCCEEDED(hr))
{
// Remember the port notify so we can use it in ResumeProcess.
m_spPortNotify = spPortNotify;
// Now launch the process in a suspended state and return the
// IDebugProcess2 interface
CComPtr<IDebugPortEx2> spPortEx;
hr = pPort->QueryInterface(&spPortEx);
if (SUCCEEDED(hr))
{
// pass on the parameters we were given (omitted here)
hr = spPortEx->LaunchSuspended(/* omitted parameters */,ppDebugProcess)
}
}
}
return(hr);
}
HRESULT CDebugEngine::ResumeProcess(IDebugProcess2 *pDebugProcess)
{
// Make a program node for this process
HRESULT hr;
CComPtr<IDebugProgramNode2> spProgramNode;
hr = this->GetProgramNodeForProcess(pProcess, &spProgramNode);
if (SUCCEEDED(hr))
{
hr = m_spPortNotify->AddProgramNode(spProgramNode);
if (SUCCEEDED(hr))
{
// resume execution of the process using the port given to us earlier.
// (Querying for the IDebugPortEx2 interface is valid here since
// that's how we got the IDebugPortNotify2 interface in the first place.)
CComPtr<IDebugPortEx2> spPortEx;
hr = m_spPortNotify->QueryInterface(&spPortEx);
if (SUCCEEDED(hr))
{
hr = spPortEx->ResumeProcess(pDebugProcess);
}
}
}
return(hr);
}