Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Drivers sobrepostos emitem solicitações de método de identificador de objeto (OID) de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para obter os parâmetros de configuração atuais de uma fila de recebimento. O InformationBuffer membro 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.
Os drivers sobrepostos emitem solicitações de conjunto OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para alterar os parâmetros de configuração atuais de uma fila. O driver sobreposto fornece um ponteiro para uma estrutura de NDIS_RECEIVE_QUEUE_PARAMETERS no InformationBuffer membro da estrutura NDIS_OID_REQUEST.
Comentários
Drivers sobrepostos emitem solicitações de conjunto OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para alterar os parâmetros de uma ou mais filas de recebimento. A solicitação de conjunto OID é opcional para drivers de miniporta NDIS 6.20 e posteriores. No entanto, a solicitação OID é obrigatória para drivers de miniporta que suportam a interface de fila de máquina virtual (VMQ).
Observação Somente o driver sobreposto que alocou a fila pode alterar os parâmetros de configuração emitindo solicitações de conjunto 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 sobrejacente 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 foi alocada, o driver sobreposto não pode 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 lida com a solicitação de método OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para drivers de miniporta 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 |
O pedido está pendente de conclusão. O NDIS passará o código de status final e os resultados para o manipulador de conclusão de 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. NDIS definir o DATA.METHOD_INFORMATION.BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário. |
NDIS_STATUS_INVALID_PARAMETER |
A solicitação falhou porque tentou habilitar um recurso que o adaptador de rede subjacente não suporta. |
NDIS_STATUS_FAILURE |
O pedido foi rejeitado por outros motivos. |
Requerimentos
Versão |
Suportado no NDIS 6.20 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |