Compartilhar via


Função NdisMSetMiniportAttributes (ndis.h)

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)

Confira também

Inicializando um adaptador miniporta

MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_ATTRIBUTES NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NDK_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES

NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES

Definindo os atributos do adaptador de miniporta NDIS 6.0