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 no OID_RECEIVE_FILTER_ALLOCATE_QUEUE OID e no OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID. 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 sobrepostos 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 recebimento, os drivers sobrepostos 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 de filtro de uma solicitação OID de método OID_RECEIVE_FILTER_SET_FILTER anterior ou da solicitação 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.