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 do método OID, o InformationBuffer membro 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 sobressoativo fornece um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS no InformationBuffer membro da estrutura NDIS_OID_REQUEST.
Observações
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 do conjunto de OID é opcional para drivers de miniporto NDIS 6.20 e posteriores. No entanto, a solicitação OID é obrigatória para drivers de miniporto que dão suporte à interface VMQ (fila de máquinas virtuais).
Observação 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 Flags membro da estrutura NDIS_RECEIVE_QUEUE_PARAMETERS. No entanto, depois que a fila tiver sido alocada, o driver em excesso não poderá alterar os parâmetros de configuração que não têm um sinalizador de alteração correspondente.
Códigos de status de retorno
O NDIS manipula a solicitação de método OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para drivers de miniporto e retorna um dos seguintes códigos de 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 de 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 o DATA.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) |