OID_RECEIVE_FILTER_QUEUE_PARAMETERS

Os drivers em excesso emitem solicitações de método OID (identificador de objeto) de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para obter os parâmetros de configuração atuais de uma fila de recebimento. O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS com um identificador de fila do tipo NDIS_RECEIVE_QUEUE_ID. Após um retorno bem-sucedido da solicitação de método OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS .

Drivers sobrepostos emitem solicitações de conjunto de OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para alterar os parâmetros de configuração atuais de uma fila. O driver sobressoido fornece um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS no membro InformationBuffer da estrutura NDIS_OID_REQUEST .

Comentários

Drivers sobrepostos emitem solicitações de conjunto de OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para alterar os parâmetros de uma ou mais filas de recebimento. A solicitação de conjunto de OID é opcional para drivers de miniporto NDIS 6.20 e posteriores. No entanto, a solicitação OID é obrigatória para drivers de miniporte que dão suporte à interface VMQ (fila de máquinas virtuais).

Nota Somente o driver sobreposto que alocou a fila pode alterar os parâmetros de configuração emitindo solicitações de conjunto de OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS.

O driver sobreposto obteve o valor de entrada do identificador de fila de uma solicitação OID do método OID_RECEIVE_FILTER_ALLOCATE_QUEUE anterior.

Depois que o driver sobreposto aloca uma fila, ele pode alterar os parâmetros de configuração que têm um sinalizador de alteração correspondente (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) no membro Flags da estrutura NDIS_RECEIVE_QUEUE_PARAMETERS . No entanto, depois que a fila tiver sido alocada, o driver de sobreposição não poderá alterar os parâmetros de configuração que não têm um sinalizador de alteração correspondente.

Retornar códigos de status

O NDIS manipula a solicitação de método OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para drivers de miniporte e retorna um dos seguintes códigos status.

Código de status	Descrição
NDIS_STATUS_SUCCESS	A solicitação foi concluída com êxito.
NDIS_STATUS_PENDING	A solicitação está pendente de conclusão. O NDIS passará o código status final e os resultados para o manipulador de conclusão da solicitação OID do chamador após a conclusão da solicitação.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações era muito curto. O NDIS define os DADOS. METHOD_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_INVALID_PARAMETER	A solicitação falhou porque tentou habilitar um recurso que o adaptador de rede subjacente não dá suporte.
NDIS_STATUS_FAILURE	A solicitação falhou por outros motivos.

Requisitos

Versão	Com suporte no NDIS 6.20 e posterior.
Cabeçalho	Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_PARAMETERS

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS