Compartilhar via


MiniportSetInformation

Windows Mobile Not SupportedWindows Embedded CE Supported

9/8/2008

Essa função é um exigido função que permite que ligado drivers protocolo ou NDIS, a solicitação alterações na informações do estado que mantém a miniporta para determinado objeto identificadores, such as as alterações no Multicast endereços.

Syntax

NDIS_STATUS MiniportSetInformation(
  NDIS_HANDLE MiniportAdapterContext,
  NDIS_OID Oid,
  PVOID InformationBuffer,
  ULONG InformationBufferLength,
  PULONG BytesRead,
  PULONG BytesNeeded
);

Parameters

  • MiniportAdapterContext
    [no] Especifica o identificador para uma área Miniport-allocated contexto no qual o driver mantém por-estado adaptador de rede, configurar por MiniportInitialize.
  • OID
    [no] Especifica o sistema-definidas OID_XXX codificar designando o operação set o driver deve executar.
  • InformationBuffer
    [no] Aponta para uma reserva contendo os dados OID-specific usados pelo MiniportSetInformation Para o conjunto.
  • InformationBufferLength
    [no] Especifica o número de bytes em InformationBuffer.
  • BytesRead
    [out] Aponta para uma variável que MiniportSetInformation Define como o número de bytes de ele ler a partir de reserva no InformationBuffer.
  • BytesNeeded
    [out] Aponta para uma variável que MiniportSetInformation Define como o número de bytes adicionais necessárias para satisfazer a solicitação se InformationBufferLength é menor que OID Requer.

Return Value

A seguinte tabela mostra os valores de status que MiniportSetInformation pode retornar.

Valor Descrição

NDIS_STATUS_SUCCESS

MiniportSetInformation Usado os dados em InformationBuffer Para definir si ou seu adaptador rede para o estado exigido pela determinado OID, e ele defina a variável no BytesRead Para a quantidade de dados fornecidos-usado.

NDIS_STATUS_PENDING

O driver será completo a solicitação de forma assíncrona com um chamar para NdisMSetInformationComplete Quando ela foi definida si ou seu adaptador rede para o estado solicitado.

NDIS_STATUS_INVALID_OID

MiniportSetInformation não reconheceu o OID.

NDIS_STATUS_INVALID_LENGTH

O InformationBufferLength não coincide com o tamanho exigido pela determinado OID. MiniportSetInformation Retornado quantos bytes de reserva deve estar no BytesNeeded.

NDIS_STATUS_INVALID_DATA

Os dados fornecidos no InformationBuffer era inválido para a determinado OID.

NDIS_STATUS_NOT_ACCEPTED

MiniportSetInformation Tentativa de operação set solicitada no adaptador de rede mas foi malsucedido.

NDIS_STATUS_NOT_SUPPORTED

MiniportSetInformation Não suporte a OID, que é opcional.

NDIS_STATUS_RESOURCES

MiniportSetInformation Não foi possível executar a operação solicitada restrições recurso devido a. Esta valor de retorno não necessariamente significar que a solicitação mesma, enviada em um tempo posterior, será falha pelo mesmo motivo.

Remarks

Chamadas NDIS MiniportSetInformation No seu próprio nome, como gerenciar as ligações para a miniporta, ou quando um ligado protocolo driver chamadas NdisRequest.

Se MiniportSetInformation Retorna NDIS_STATUS_PENDING, o driver deve completo a solicitação posteriormente por chamado NdisMSetInformationComplete. Até que ela conclua qualquer solicitação, a miniporta segura pode acessar a memória em InformationBuffer, BytesRead, e BytesNeeded. Após a miniporta concluir qualquer solicitação conjunto, a propriedade dessas variáveis e a reserva reverte para o driver que alocados a memória, NDIS ou o chamador de NdisRequest.

Após um chamar para MiniportSetInformationNDIS, não envia nenhuma outras solicitações para o driver até que ele tenha concluído a operação, ou sincronicamente de forma assíncrona. Em vez disso, NDIS mantém solicitações enfileirado até o atual operação set for concluída.

MiniportSetInformation Pode ser Pre-empted por uma interrupção.

Requirements

Header externs.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

MiniportInitialize
NdisMSetInformationComplete
NdisRequest