Obtendo e atualizando parâmetros de fila de VM

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

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

A estrutura de NDIS_RECEIVE_QUEUE_PARAMETERS é usada no OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE e no OID 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 overlying podem usar a solicitação OID do método OID_RECEIVE_FILTER_QUEUE_PARAMETERS. O membro InformationBuffer da estrutura NDIS_OID_REQUEST inicialmente 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 .

O NDIS manipula a solicitação de método para drivers de miniport. Portanto, a solicitação OID do método OID_RECEIVE_FILTER_QUEUE_PARAMETERS não é solicitada para drivers de miniporto. 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.

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

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

Drivers sobrepostos podem usar a solicitação OID do método OID_RECEIVE_FILTER_PARAMETERS para obter os parâmetros de configuração de um filtro em uma fila de recebimento.

O driver sobreposto obteve o identificador de filtro de uma solicitação OID do método OID_RECEIVE_FILTER_SET_FILTER anterior ou da solicitação OID do OID_RECEIVE_FILTER_ENUM_FILTERS . Somente os drivers podem usar a solicitação OID_RECEIVE_FILTER_SET_FILTER.

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