MiniportSetInformation
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 |