OID_RECEIVE_FILTER_ENUM_QUEUES

Drivers sobrepostos e aplicativos de modo de usuário emitem solicitações de consulta de identificador de objeto (OID) 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 InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_INFO_ARRAY que é 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 que recebeu das solicitações OID_RECEIVE_FILTER_ALLOCATE_QUEUE e OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID.

Drivers sobrepostos 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 emite a solicitação, o tipo de solicitação dentro da estrutura NDIS_OID_REQUEST é definido como NdisRequestQueryInformation e esse OID retorna uma matriz de todas as filas de recebimento que o driver de protocolo alocado no adaptador de rede. Se um aplicativo de modo de usuário emitiu a solicitação, o tipo de solicitação dentro da estrutura NDIS_OID_REQUEST é definido como NdisRequestQueryStatistics, e esse OID retorna 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 do 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	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_FAILURE	O pedido foi rejeitado por outros motivos.