NdisReadNetworkAddress
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função retorna o software-configurável endereço rede que foram armazenado no Registro para um NIC quando ele foi instalado no computador a.
Syntax
VOID NdisReadNetworkAddress(
PNDIS_STATUS Status,
PVOID* NetworkAddress,
PUINT NetworkAddressLength,
NDIS_HANDLE ConfigurationHandle
);
Parameters
- Status
[out] Ponteiro para uma variável Caller-supplied no qual essa função retorna o status do chamar.
- Endereço_de_rede
[out] Ponteiro para uma variável Caller-supplied no qual essa função retorna um ponteiro para o armazenada em buffer endereço rede, armazenado como uma seqüência de números inteiros byte, se a chamar é bem-sucedido.
- NetworkAddressLength
[out] Ponteiro para uma variável Caller-supplied no qual essa função retorna o número de bytes retornados no Endereço_de_rede.
- ConfigurationHandle
[no] Identificador retornado pela NdisOpenConfiguration função.
Return Value
A seguinte tabela mostra os valores de retorno para esta função.
| Valor | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
O chamador pode usar o endereço retornado no Endereço_de_rede Para seu NIC. |
NDIS_STATUS_FAILURE |
Não havia nenhuma informações endereço NIC disponível em Registro do chamador Parms chave, ou o valor armazenado não era um seqüência de caracteres. |
Remarks
Para placas de rede cartão PC, se nenhum endereço rede foi especificado no Registro, NDIS lê o endereço rede a partir atributo espaço do cartão de e armazena-la no Registro.
Essa função procura o Registro Parâmetros chave designado por especificado ConfigurationHandle Para o palavra-chave Endereço_de_rede, converte o valor deste seqüência de caracteres-entrada tipo em uma seqüência de números inteiros byte e armazena as informações solicitadas internamente. O armazenamento que NDIS aloca para tal um endereço permanece válido até que chama o driver NIC NdisCloseConfiguration, que libera a memória.
O chamador não é possível usar a variável no Endereço_de_rede Como um ponteiro, a menos que essa função retorna NDIS_STATUS_SUCCESS em Status.
Programa de instalação para uma NIC que ofereça suporte ao software-configurável de resolução rede armazena uma entrada valor nomeado com o Endereço_de_rede palavra-chave no apropriado XXX\DriverName\Parms chave do Registro.
Um instalador NIC geralmente armazena o valor de um Endereço_de_rede entrada no Registro como um seqüência de caracteres de hexadecimal dígitos. Opcionalmente, um instalador pode armazenar tal um endereço como um seqüência de caracteres de combinado dígitos, com cada par separados do próximo por um hífen. Essa função descarta hifens e converte cada tal par em um único byte.
Em qualquer forma, essa função converte o endereço especificado como um seqüência de caracteres, um caractere em um tempo, para o equivalente inteiro até o seqüência de caracteres é esgotado.
O Registro Windows Embedded CE, tais um seqüência de caracteres endereço instalado contém caracteres Unicode.
Requirements
| Header | ndis.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |