estrutura NDIS_IPSEC_OFFLOAD_V1 (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_IPSEC_OFFLOAD_V1 fornece informações de descarregamento de tarefa IPsec (segurança de protocolo internet) na estrutura NDIS_OFFLOAD .

ObserveNDIS_IPSEC_OFFLOAD_V1 é apenas para NDIS 6.0. Para o NDIS 6.1 e posterior, use NDIS_IPSEC_OFFLOAD_V2.

Sintaxe

typedef struct _NDIS_IPSEC_OFFLOAD_V1 {
  struct {
    ULONG Encapsulation;
    ULONG AhEspCombined;
    ULONG TransportTunnelCombined;
    ULONG IPv4Options;
    ULONG Flags;
  } Supported;
  struct {
    ULONG Md5 : 2;
    ULONG Sha_1 : 2;
    ULONG Transport : 2;
    ULONG Tunnel : 2;
    ULONG Send : 2;
    ULONG Receive : 2;
  } IPv4AH;
  struct {
    ULONG Des : 2;
    ULONG Reserved : 2;
    ULONG TripleDes : 2;
    ULONG NullEsp : 2;
    ULONG Transport : 2;
    ULONG Tunnel : 2;
    ULONG Send : 2;
    ULONG Receive : 2;
  } IPv4ESP;
} NDIS_IPSEC_OFFLOAD_V1, *PNDIS_IPSEC_OFFLOAD_V1;

Membros

Supported

Uma estrutura no NDIS_IPSEC_OFFLOAD_V1 que especifica o suporte para descarregamento de tarefas IPsec e que contém as seguintes informações:

Supported.Encapsulation

Configurações de encapsulamento para IPsec. Para obter mais informações sobre esse membro, consulte a seção Comentários a seguir.

Supported.AhEspCombined

Um valor ULONG que um driver de miniporte define para indicar que o hardware pode executar operações IPsec no envio e recebimento de pacotes que contêm uma carga de segurança ah (cabeçalho de autenticação) e uma ESP (carga de segurança encapsulada). Um valor zero em AhEspCombined indica que a NIC não dá suporte a essa funcionalidade.

Supported.TransportTunnelCombined

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode processar cargas de segurança para a parte do modo de transporte e a parte do modo de túnel dos pacotes de envio e recebimento. (A parte do modo de transporte de um pacote pertence a uma conexão de ponta a ponta. A parte do modo de túnel de um pacote pertence a uma conexão de túnel.) Um valor zero em TransportTunnelCombined indica que a NIC não dá suporte a essa funcionalidade.

Supported.IPv4Options

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode executar operações IPsec no IPv4 enviar e receber pacotes cujos cabeçalhos IP contêm opções de IP. Um valor zero em IPv4Options indica que a NIC não dá suporte a essa funcionalidade.

Supported.Flags

Os tipos de pacotes de dados ESP encapsulados por UDP que a NIC pode analisar. Para obter uma descrição dos tipos de encapsulamento UDP, consulte Tipos de encapsulamento UDP-ESP. Esse membro pode ser um ou mais dos seguintes sinalizadores:

Valor	Significado
IPSEC_TPT_UDPESP_ENCAPTYPE_IKE	Reservado para uso interno.
IPSEC_TUN_UDPESP_ENCAPTYPE_IKE	Reservado para uso interno.
IPSEC_TPTOVERTUN_UDPESP_ENCAPTYPE_IKE	Reservado para uso interno.
IPSEC_TPT_UDPESP_OVER_PURE_TUN_ENCAPTYPE_IKE	Reservado para uso interno.
IPSEC_TPT_UDPESP_ENCAPTYPE_OTHER	Quando esse sinalizador é definido, a NIC pode analisar pacotes de modo de transporte encapsulados por UDP. Quando esse sinalizador é limpo, a NIC não pode analisar pacotes de modo de transporte encapsulados por UDP.
IPSEC_TUN_UDPESP_ENCAPTYPE_OTHER	Quando esse sinalizador é definido, a NIC pode analisar pacotes de modo de túnel encapsulados por UDP. Quando esse sinalizador é limpo, a NIC não tem essa funcionalidade.
IPSEC_TPTOVERTUN_UDPESP_ENCAPTYPE_OTHER	Quando esse sinalizador é definido, a NIC pode analisar o transporte em pacotes de modo de túnel encapsulados por UDP. Quando esse sinalizador é limpo, a NIC não tem essa funcionalidade.
IPSEC_TPT_UDPESP_OVER_PURE_TUN_ENCAPTYPE_OTHER	Quando esse sinalizador é definido, a NIC pode analisar o transporte encapsulado por UDP em pacotes de modo de túnel. Quando esse sinalizador é limpo, a NIC não tem essa funcionalidade.

Um driver de miniporto cuja NIC é incapaz de analisar pacotes ESP encapsulados por UDP não deve definir nenhum sinalizador no membro Flags .

IPv4AH

Uma estrutura dentro de NDIS_IPSEC_OFFLOAD_V1 que especifica o suporte para cargas ah e que contém as seguintes informações:

IPv4AH.Md5

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode usar o algoritmo MD5 com chave para computação ou validação de uma soma de verificação criptográfica para uma carga AH, conteúdo ESP ou ambos.

IPv4AH.Sha_1

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode usar o algoritmo SHA 1 para computação ou validação de uma soma de verificação criptográfica para uma carga AH, conteúdo ESP ou ambos.

IPv4AH.Transport

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode calcular ou validar as somas de verificação criptográficas para a parte de um pacote que pertence a uma conexão de ponta a ponta.

IPv4AH.Tunnel

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode calcular ou validar somas de verificação criptográficas para a parte de um pacote que pertence a uma conexão de túnel.

IPv4AH.Send

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode calcular somas de verificação criptográficas para enviar pacotes.

IPv4AH.Receive

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode validar somas de verificação criptográficas para pacotes de recebimento.

IPv4ESP

Uma estrutura dentro de NDIS_IPSEC_OFFLOAD_V1 que especifica o suporte para cargas ESP e que contém as seguintes informações:

IPv4ESP.Des

Um valor ULONG que um driver de miniporto define para indicar que a NIC dá suporte ao algoritmo DES para criptografar e descriptografar cargas ESP.

IPv4ESP.Reserved

Este membro está reservado.

IPv4ESP.TripleDes

Um valor ULONG que um driver de miniporto define para indicar que a NIC dá suporte ao algoritmo triple-DES para criptografar e descriptografar cargas ESP.

IPv4ESP.NullEsp

Um valor ULONG que um driver de miniporto define para indicar que a NIC dá suporte à criptografia nula, ou seja, o conteúdo ESP sem criptografia, mas com informações de autenticação.

IPv4ESP.Transport

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode criptografar e descriptografar dados ESP para a parte de um pacote que pertence a uma conexão de ponta a ponta.

IPv4ESP.Tunnel

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode criptografar e descriptografar dados ESP para a parte de um pacote que pertence a uma conexão de túnel.

IPv4ESP.Send

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode criptografar e descriptografar cargas ESP em pacotes de envio.

IPv4ESP.Receive

Um valor ULONG que um driver de miniporto define para indicar que a NIC pode criptografar e descriptografar cargas ESP em pacotes de recebimento.

Comentários

A estrutura NDIS_IPSEC_OFFLOAD_V1 é usada no membro IPsecV1 da estrutura NDIS_OFFLOAD . A estrutura NDIS_IPSEC_OFFLOAD_V1 especifica os serviços atuais ou com suporte que um adaptador de miniporto fornece para IPsec (segurança de protocolo de Internet).

NDIS_OFFLOAD é usado no estrutura NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES , estrutura NDIS_BIND_PARAMETERS , NDIS_FILTER_ATTACH_PARAMETERS estrutura, OID_TCP_OFFLOAD_CURRENT_CONFIG OID e o NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indicação status.

Para OID_TCP_OFFLOAD_CURRENT_CONFIG, a estrutura NDIS_OFFLOAD especifica os recursos de descarregamento de tarefa compatíveis com um adaptador de miniporto. Se os recursos de descarregamento atuais forem alterados, um driver de miniporte relatará os novos recursos em um NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indicação status.

O membro encapsulamento do NDIS_IPSEC_OFFLOAD_V1 define as configurações de encapsulamento de descarregamento IPsec para o adaptador de miniporte.

Em resposta a um OID_TCP_OFFLOAD_CURRENT_CONFIG solicitação de consulta, o NDIS fornece um OR bit a bit dos sinalizadores de encapsulamento, que indicam as configurações de encapsulamento com suporte, no membro Encapsulamento . Os drivers de miniporto devem fornecer encapsulamento Ethernet (NDIS_ENCAPSULATION_IEEE_802_3). Os outros tipos de encapsulamento são opcionais.

Para um NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indicação status, o driver de miniporto fornece um OR bit a bit dos sinalizadores de encapsulamento, que indicam os recursos atuais, no membro Encapsulamento.

Os seguintes sinalizadores são definidos para o membro encapsulamento :