NdisMSetAttributes

9/8/2008

Essa função informa a biblioteca NDIS sobre recursos significativos do chamador NIC durante inicialização.

Syntax

VOID NdisMSetAttributes(
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_HANDLE MiniportAdapterContext,
  BOOLEAN BusMaster,
  NDIS_INTERFACE_TYPE AdapterType
);

Parameters

• MiniportAdapterHandle
  [no] Manipular entrada para o MiniportInitialize função.

• MiniportAdapterContext
  [no] Identificador de uma área contexto residente alocada pelo MiniportInitialize.

• BusMaster
  [no] Especifica se o chamador é NIC TRUE é um mestre barramento acesso direto à memória (DMA) dispositivo.

• AdapterType
  [no] Especifica o tipo interface barramento E/S do do chamador NIC, que geralmente é o tipo de barramento E/S no qual o NIC é conectado, como um do seguinte.

  Valor	Descrição
  NdisInterfaceInternal	Especifica uma interface interna host-specific.
  NdisInterfaceIsa	Especifica a interface ISA.
  NdisInterfacePci	Especifica a interface Peripheral Component Interconnect (PCI).
  NdisInterfacePCMcia	Especifica a interface Personal Computer Memory Card International Association (PCMCIA).

Return Value

Nenhum.

Remarks

A MiniportInitialize função deve chamar esta função ou NdisMSetAttributesEx Antes chamado qualquer outro NdisMRegisterXXX Ou NDISXXXfunção que depende de informações fornecidas para esta função ou NdisMSetAttributesEx.

Em geral, um driver NIC deve chamar esta função ou NdisMSetAttributesEx antes de ele chama qualquer NDISXXX função que alega recursos hardware o Registro para o NIC porque NDIS deve ter o BusMaster Ou AttributeFlags valor, respectivamente, antes tal um chamar é feita e porque o driver geralmente precisa de memória em MiniportAdapterContext Para armazenar informações para essas chamadas. Essa restrição implica que do um driver NIC MiniportInitialize função não é possível chamar a seguinte NDISXXX funções antes ela chama essa função ou NdisMSetAttributesEx:

• NdisMPciAssignResources
• NdisMAllocateSharedMemory
• NdisMMapIoSpace
• NdisMRegisterInterrupt
• NdisMRegisterIoPortRange e, conseqüentemente, o NdisRawXXXPortaXXX funções

No entanto, antes chamado essa função ou NdisMSetAttributesEx, um driver NIC pode chamar as funções configuração NDIS para recuperar informações configuração instaladas no Registro. MiniportInitialize Também pode chamar o barramento - tipo - específico NdisReadXXX funções, como NdisReadPciSlotInformation, desde que a entrada Registro instalado para interface tipo do driver corresponde a específicas barramento - tipo - NdisReadXXX MiniportInitialize Chamadas.

O MiniportAdapterContext identificador fornecido para essa função ou NdisMSetAttributesEx se torna um parâmetro de entrada para todos MiniportaXXX funções que foram registradas, além com MiniportInitialize, na chamar para NdisMRegisterMiniport. Normalmente, este identificador é um ponteiro para memória residente, alocada pelo MiniportInitialize, no qual o driver mantém executar NIC-specific-estado tempo.

Drivers intermediários devem chamar NdisMSetAttributesEx, rather than esta função. Drivers NIC podem chamar um dessas funções, mas NdisMSetAttributesEx Permite que uma miniporta ajustar os intervalos no qual seu MiniportCheckForHang e MiniportReset funções são chamado.

Requirements

Header	ndis.h
Library	ndis.dll
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

MiniportCheckForHang
MiniportInitialize
MiniportReset
NdisMAllocateSharedMemory
NdisMMapIoSpace
NdisMPciAssignResources
NdisMRegisterInterrupt
NdisMRegisterIoPortRange
NdisReadPciSlotInformation
NdisMRegisterMiniport
NdisMSetAttributesEx
NdisOpenConfiguration
NdisWritePciSlotInformation