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