Registrando-se para notificações de SAN NIC

Quando um driver proxy recebe uma solicitação de seu provedor de serviços SAN associado para fornecer a lista de endereços IP atribuídos a NICs sob o controle do driver, o driver determina e passa essa lista para o provedor.

Para obter esses endereços IP, o driver proxy deve se registrar na TDI (Interface do Driver de Transporte) para receber notificações de alteração de endereço. O driver proxy chama a função TdiRegisterPnPHandlers . Nessa chamada, esse driver proxy passa ponteiros para funções de retorno de chamada nos membros AddAddressHandlerV2 e DelAddressHandlerV2 da estrutura TDI_CLIENT_INTERFACE_INFO para especificar funções de retorno de chamada para adições e exclusões de endereço. Depois que a função TdiRegisterPnPHandlers tiver retornado com êxito, a TDI indicará imediatamente todos os endereços de rede ativos no momento para o driver proxy, usando o retorno de chamada de adição de endereço. A indicação contém endereços de rede e identificadores para os dispositivos aos quais esses endereços estão associados.

Sempre que a TDI chama uma dessas funções de retorno de chamada para indicar adições ou exclusões de endereço, o driver proxy requer os seguintes parâmetros:

Endereço
Ponteiro para uma estrutura TA_ADDRESS que descreve o endereço de rede atribuído ou removido da NIC. No caso de TCP/IP, esse ponteiro é, na verdade, um ponteiro para uma estrutura TA_ADDRESS_IP.

Devicename
Ponteiro para uma cadeia de caracteres Unicode que identifica a associação de transporte para NIC à qual o endereço está associado. No caso de TCP/IP, a cadeia de caracteres Unicode tem o seguinte formato: \Device\Tcpip_{NIC-GUID}, em que NIC-GUID é o identificador global exclusivo atribuído pelo subsistema de configuração de rede à NIC.

As definições de estrutura anteriores são definidas no arquivo de cabeçalho tdi.h. As funções de registro e retorno de chamada anteriores são definidas no arquivo de cabeçalho tdikrnl.h. Esses arquivos de cabeçalho estão disponíveis no DDK (Microsoft Windows Driver Development Kit) e no WDK (Kit de Driver do Windows). Para obter informações detalhadas sobre notificações de TDI Plug and Play (PnP), consulte Retornos de chamada do cliente TDI e Manipuladores de notificações PnP e eventos do cliente TDI.

Na inicialização do sistema, a TDI chama o retorno de chamada de adição de endereço do driver proxy para indicar todos os endereços IP ativos no momento. A TDI também chama esse retorno de chamada sempre que o protocolo de transporte TCP/IP registra um novo endereço IP com TDI. O driver proxy inclui em sua lista de endereços IP apenas os endereços atribuídos às NICs do driver proxy. O retorno de chamada de adição de endereço do driver deverá retornar o controle imediatamente se o driver não reconhecer a NIC em DeviceName.

A TDI chama o retorno de chamada de remoção de endereço do driver proxy sempre que o protocolo de transporte TCP/IP indica à TDI que uma NIC foi removida. Se o endereço IP da NIC pertencer a uma das NICs do driver proxy, o driver proxy removerá o endereço IP da lista.

Nota A TDI não terá suporte nas versões do Microsoft Windows após o Windows Vista. Em vez disso, use a Plataforma de Filtragem do Windows ou o Kernel winsock .