Função NdisRegisterProtocolDriver (ndis.h)

  • Artigo

Um driver de protocolo chama a função NdisRegisterProtocolDriver para registrar suas funções ProtocolXxx com NDIS.

Sintaxe

NDIS_STATUS NdisRegisterProtocolDriver(
  [in, optional] NDIS_HANDLE                           ProtocolDriverContext,
  [in]           PNDIS_PROTOCOL_DRIVER_CHARACTERISTICS ProtocolCharacteristics,
  [out]          PNDIS_HANDLE                          NdisProtocolHandle
);

Parâmetros

[in, optional] ProtocolDriverContext

Um identificador para uma área de contexto alocada por driver em que o driver mantém informações de estado e configuração.

[in] ProtocolCharacteristics

Um ponteiro para um NDIS_PROTOCOL_DRIVER_CHARACTERISTICS estrutura que o driver de protocolo criou e inicializou com seus pontos de entrada de função ProtocolXxx .

[out] NdisProtocolHandle

Um ponteiro para uma variável de identificador fornecida pelo chamador. O NDIS grava um identificador nessa variável que identifica exclusivamente o driver que está se registrando. O driver deve salvar esse identificador para uso em chamadas de função NdisXxx subsequentes.

Retornar valor

NdisRegisterProtocolDriver retorna um dos seguintes valores de status:

Código de retorno Descrição
NDIS_STATUS_SUCCESS

NdisRegisterProtocolDriver retornará NDIS_STATUS_SUCCESS se tiver registrado o driver de protocolo.
NDIS_STATUS_BAD_VERSION
 A versão especificada no membro MajorNdisVersion da estrutura em ProtocolCharacteristics é inválida.
NDIS_STATUS_BAD_CHARACTERISTICS
 Alguns membros da estrutura no parâmetro ProtocolCharacteristics são inválidos.
NDIS_STATUS_RESOURCES

NdisRegisterProtocolDriver falhou devido a recursos insuficientes.
NDIS_STATUS_FAILURE

NdisRegisterProtocolDriver retornará NDIS_STATUS_FAILURE se nenhum dos valores anteriores se aplicar.

Comentários

Um driver de protocolo chama a função NdisRegisterProtocolDriver de sua rotina DriverEntry . Para obter mais informações sobre DriverEntry, consulte DriverEntry of NDIS Protocol Drivers.

Os drivers que chamam NdisRegisterProtocolDriver devem estar preparados para uma chamada imediata para qualquer uma de suas funções ProtocolXxx .

Cada driver de protocolo exporta um conjunto de funções ProtocolXxx configurando o NDIS_PROTOCOL_DRIVER_CHARACTERISTICS estrutura e chamando NdisRegisterProtocolDriver. O NDIS copia essa estrutura para o armazenamento interno da biblioteca NDIS.

Para permitir que os drivers de protocolo registrem serviços opcionais, o NDIS chama a função ProtocolSetOptions dentro do contexto de NdisRegisterProtocolDriver.

Os drivers de protocolo chamam o Função NdisDeregisterProtocolDriver para liberar recursos que foram alocados anteriormente com NdisRegisterProtocolDriver.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI Irql_Protocol_Driver_Function(ndis)

Confira também

DriverEntry de drivers de protocolo NDIS

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS

NdisDeregisterProtocolDriver

NdisSetOptionalHandlers