OID_PACKET_COALESCING_FILTER_MATCH_COUNT
O NDIS emite uma solicitação de consulta OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT para obter o número de pacotes que foram armazenados em cache ou agrupados no adaptador de rede. O adaptador de rede unirá os pacotes recebidos se o adaptador estiver habilitado para a união de pacotes NDIS e o pacote corresponder a um filtro de recebimento.
O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma variável ULONG64 alocada pelo chamador. Antes de um retorno bem-sucedido da solicitação de consulta, o driver atualiza a variável ULONG64 com o número de pacotes correspondentes recebem filtros no adaptador de rede.
Comentários
A partir do NDIS 6.30, os drivers que dão suporte à união de pacotes NDIS devem dar suporte a solicitações de consulta OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT.
Nota Drivers que dão suporte a interfaces sr-IOV (virtualização de E/S) raiz única ou VMQ (fila de máquinas virtuais) não são necessários para dar suporte a solicitações de consulta OID dessa OID.
Um driver de miniporte que dá suporte à união de pacotes deve incrementar um contador ULONG64 para cada pacote recebido que foi agrupado no adaptador de rede. Os pacotes serão agrupados se corresponderem a um filtro de recebimento, que os drivers sobrepostos baixam para o driver de miniporto por meio de solicitações de método OID de OID_RECEIVE_FILTER_SET_FILTER.
O driver retorna o valor desse contador quando lida com uma solicitação de consulta OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT.
O driver de miniporte não deve limpar o contador depois de manipular a solicitação de consulta OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT. O driver de miniporte só deverá limpar o contador se as seguintes condições forem verdadeiras:
O driver de miniporte manipula uma solicitação de conjunto de OID de OID_PNP_SET_POWER para retomar para um estado de energia total de NdisDeviceStateD0.
O NDIS chama a função MiniportResetEx do driver de miniport para redefinir o adaptador de rede subjacente.
Para obter mais informações sobre a união de pacotes, consulte Agrupamento de pacotes NDIS.
Retornar códigos de status
O driver de miniporto retorna um dos seguintes códigos status para a solicitação de método OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT:
NDIS_STATUS_SUCCESS
A solicitação OID foi concluída com êxito.
NDIS_STATUS_INVALID_LENGTH
O buffer de informações era muito curto. O driver define os DADOS. SET_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_FAILURE
A solicitação falhou por outros motivos.
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |