Função NdisMSetMiniportAttributes (ndis.h)

Artigo
08/07/2023

Um driver de miniporto deve chamar a função NdisMSetMiniportAttributes de sua função MiniportInitializeEx para identificar uma área de contexto para o adaptador de miniporto para NDIS e fornecer ao NDIS informações sobre o adaptador de miniporto.

Sintaxe

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

Parâmetros

NdisMiniportHandle

O identificador do adaptador de miniporta que o NDIS passou para o parâmetro MiniportAdapterHandle de MiniportInitializeEx.

[in] MiniportAttributes

Um ponteiro para um NDIS_MINIPORT_ADAPTER_ATTRIBUTES união que contém uma estrutura de atributos alocados por driver. A estrutura define os atributos da instância do adaptador miniport que MiniportAdapterHandle especifica.

Retornar valor

NdisMSetMiniportAttributes retorna um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes registrou com êxito os atributos do adaptador de miniport.
NDIS_STATUS_BAD_VERSION	Indica que o NDIS não dá suporte à versão especificada no membro Revision da estrutura especificada no membro Header em MiniportAttributes .

Comentários

Um driver de miniporto deve chamar NdisMSetMiniportAttributes de sua função MiniportInitializeEx antes que o driver chame qualquer outra função NdisXxx que dependa das informações fornecidas a NdisMSetMiniportAttributes.

O NDIS_MINIPORT_ADAPTER_ATTRIBUTES união é um espaço reservado para várias estruturas de atributos. Um driver de miniporto chama NdisMSetMiniportAttributes várias vezes com estruturas de atributos diferentes. Um driver de miniporta deve fornecer um inicializado NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES estrutura de MiniportInitializeEx. O driver de miniporta deve fornecer esses atributos de registro antes de chamar qualquer outra função NdisXxx que dependa desses atributos ou que declara recursos de hardware.

O driver fornece um membro MiniportAdapterContext ao NDIS na estrutura NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES . O membro MiniportAdapterContext identifica uma área de contexto fornecida pelo chamador que o NDIS passa como um parâmetro de entrada para as funções MiniportXxx do driver. Essa área de contexto contém informações de estado específicas do adaptador de miniport.

Os drivers de miniport devem definir os atributos no NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES estrutura depois de definir os atributos de registro na estrutura NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES e antes de definirem atributos adicionais.

Um driver de miniporto também pode chamar NdisMSetMiniportAttributes de sua função MiniportAddDevice . Nesse caso, a estrutura NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES é usada para especificar a área de contexto.

Requisitos

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