OID_RECEIVE_FILTER_ENUM_QUEUES
Drivers e aplicativos de modo de usuário em excesso emitem solicitações de consulta OID (identificador de objeto) de OID_RECEIVE_FILTER_ENUM_QUEUES para obter uma lista de todas as filas de recebimento alocadas em um adaptador de rede.
Após um retorno bem-sucedido da solicitação de consulta OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_INFO_ARRAY seguida por uma estrutura NDIS_RECEIVE_QUEUE_INFO para cada filtro.
Comentários
O NDIS obteve as informações de um cache interno dos dados recebidos do OID_RECEIVE_FILTER_ALLOCATE_QUEUE e OID_RECEIVE_FILTER_QUEUE_PARAMETERS solicitações OID.
Drivers e aplicativos de modo de usuário emitem solicitações de consulta OID de OID_RECEIVE_FILTER_ENUM_QUEUES para enumerar as filas de recebimento em um adaptador de rede.
Se um driver de protocolo emitir a solicitação, o tipo de solicitação dentro da estrutura NDIS_OID_REQUEST será definido como NdisRequestQueryInformation e esse OID retornará uma matriz de todas as filas de recebimento alocadas pelo driver de protocolo no adaptador de rede. Se um aplicativo de modo de usuário tiver emitido a solicitação, o tipo de solicitação dentro da estrutura NDIS_OID_REQUEST será definido como NdisRequestQueryStatistics e esse OID retornará uma matriz de informações para todas as filas de recebimento no adaptador de rede.
Códigos de status de retorno
O NDIS lida com a solicitação de consulta OID de OID_RECEIVE_FILTER_ENUM_QUEUES 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. O InformationBuffer aponta para uma estrutura NDIS_RECEIVE_QUEUE_INFO_ARRAY . |
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 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. 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_FAILURE |
A solicitação falhou por outros motivos. |
Requisitos
Versão |
Com suporte no NDIS 6.20 e posterior. |
parâmetro |
Ntddndis.h (inclua Ndis.h) |