Função NdisMSetMiniportAttributes (ndis.h)

Artigo
02/07/2025

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 miniporto 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 alocada por driver. A estrutura define os atributos da instância do adaptador de miniporto que especifica MiniportAdapterHandle.

Valor de retorno

NdisMSetMiniportAttributes retorna um dos seguintes valores de status:

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

Observações

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 para 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 miniporto deve fornecer uma inicialização NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES estrutura de MiniportInitializeEx. O driver de miniporto deve fornecer esses atributos de registro antes de chamar qualquer outro Ndisxxx função que depende desses atributos ou que declara recursos de hardware.

O driver fornece um membro MiniportAdapterContext para o 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 de miniportXxx do driver. Essa área de contexto contém informações de estado específicas do miniporto-adaptador.

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

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

Requisitos

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