Obtendo e atualizando parâmetros de fila de VM

Um driver sobreposto pode definir os parâmetros de configuração de uma fila de VM depois que ela é alocada. Além disso, um driver ou aplicativo subjacente pode obter os parâmetros atuais de uma fila e os parâmetros para os filtros definidos numa fila.

Para alterar os parâmetros de configuração atuais de uma fila, os drivers sobrepostos podem usar o OID_RECEIVE_FILTER_QUEUE_PARAMETERS definir a solicitação OID. O driver sobreposto fornece um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS no membro InformationBuffer da estrutura NDIS_OID_REQUEST.

A estrutura NDIS_RECEIVE_QUEUE_PARAMETERS é usada nos OIDs OID_RECEIVE_FILTER_ALLOCATE_QUEUE e OID_RECEIVE_FILTER_QUEUE_PARAMETERS. Para obter mais informações sobre como alocar filas, consulte Alocando uma fila de VM.

Para obter os parâmetros de configuração atuais de uma fila, os drivers subjacentes podem usar a solicitação OID do método OID_RECEIVE_FILTER_QUEUE_PARAMETERS. O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém inicialmente 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 membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS.

O NDIS lida com a solicitação de método para drivers de miniportas. Portanto, a solicitação OID do método OID_RECEIVE_FILTER_QUEUE_PARAMETERS não é solicitada para drivers de miniporta. O NDIS obteve as informações de um cache interno dos dados que recebeu do OID_RECEIVE_FILTER_ALLOCATE_QUEUE e OID_RECEIVE_FILTER_QUEUE_PARAMETERS solicitações OID.

Para obter os parâmetros de configuração atuais de um filtro em uma fila de receção, os drivers superiores podem usar a solicitação OID do método OID_RECEIVE_FILTER_PARAMETERS. O InformationBuffer membro da estrutura NDIS_OID_REQUEST inicialmente contém um ponteiro para uma estrutura NDIS_RECEIVE_FILTER_PARAMETERS. O NDIS usa o membro FilterId na estrutura de entrada para identificar o filtro. Após um retorno bem-sucedido da solicitação de método, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_RECEIVE_FILTER_PARAMETERS atualizada.

O NDIS lida com a solicitação OID do método OID_RECEIVE_FILTER_PARAMETERS para drivers de miniporta. O NDIS obteve as informações de um cache interno dos dados que recebeu da solicitação OID_RECEIVE_FILTER_SET_FILTER OID.

Os drivers superiores podem usar a requisição OID do método OID_RECEIVE_FILTER_PARAMETERS para obter os parâmetros de configuração de um filtro numa fila de receção.

O driver sobreposto obteve o identificador do filtro a partir de um pedido OID anterior do método OID_RECEIVE_FILTER_SET_FILTER ou do pedido OID OID_RECEIVE_FILTER_ENUM_FILTERS. Somente os condutores podem usar a solicitação OID_RECEIVE_FILTER_SET_FILTER.

Um aplicativo obteve o identificador de filtro da solicitação OID_RECEIVE_FILTER_ENUM_FILTERS OID.