NdisMRegisterIoPortRange

9/8/2008

Essa função configura acessar driver às portas dispositivo E/S com o NdisRawReadPortXXX e NdisRawWritePortXXX funções e reivindicações os endereços porta range of I/O o Registro para NIC. desse driver

Syntax

NDIS_STATUS NdisMRegisterIoPortRange(
  PVOID* PortOffset,
  NDIS_HANDLE MiniportAdapterHandle,
  UINT InitialPort,
  UINT NumberOfPorts
);

Parameters

• PortOffset
  [out] Especifica uma variável Caller-supplied no qual essa função retorna o endereço virtual de base mapeada para o barramento especificado-relativo intervalo de portas E/S especificado por InitialPort e NumberOfPorts.

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

• InitialPort
  [no] Especifica o barramento-relativo endereço porta de base para um intervalo de portas a serem mapeados.

• NumberOfPorts
  [no] Especifica o número de portas no intervalo a ser mapeada.

Return Value

A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
NDIS_STATUS_SUCCESS	As portas range of I/O especificado foi mapeado com êxito; o valor no PortOffset é válido e a mapeada intervalo tem foi solicitado no Registro para a NIC.
NDIS_STATUS_RESOURCE_CONFLICT	Possui uma tentativa reclamar de intervalo de portas E/S in o Registro falha, possivelmente porque outro driver solicitado já o intervalo para seu dispositivo. Essa função registra um erro se isso ocorrer.
NDIS_STATUS_RESOURCES	O intervalo de portas não pôde ser mapeado, ou NDIS não pôde alocar recursos para verificar o Registro de hardware-recurso conflitos.
NDIS_STATUS_FAILURE	O tipo barramento ou barramento número está fora do intervalo, ou o especificado InitialPort e NumberOfPorts Foram inválido, possivelmente não dentro de espaço porta E/S do atual plataforma.

Remarks

Um driver NIC chama essa função do seu MiniportInitialize função. MiniportInitialize deve chamar NdisMSetAttributes Ou NdisMSetAttributesEx Antes chamado essa função.

Essa função mapeia um barramento-relativo dispositivo intervalo do endereço que a miniporta pode usar posteriormente para acessar um E/S intervalo de portas no seu NIC por chamado de NdisRawXXX funções. Um bem-sucedido chamar alega as portas especificados range of I/O o Registro para NIC. do chamador

Se seu chamar para esta função falhar, MiniportInitialize Libera todos os recursos que ele já foi alocado para seu NIC e então falha inicialização para que NIC.

Drivers de placas de rede com dispositivo registra em chamar espaço de memória hospedar NdisMMapIoSpace e, conseqüentemente, o NdisRead/WriteRegisterXXX funções para acessar o NIC registra.

Requirements

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

See Also

Reference

MiniportInitialize
NdisMMapIoSpace
NdisMSetAttributes
NdisMSetAttributesEx
NdisMDeregisterIoPortRange
NdisRawReadPortBufferUchar
NdisRawReadPortBufferUlong
NdisRawReadPortBufferUshort
NdisRawReadPortUchar
NdisRawReadPortUlong
NdisRawReadPortUshort
NdisRawWritePortUchar
NdisRawWritePortUlong
NdisRawWritePortUshort