Gerir informações de estado da funcionalidade de switch personalizado

A interface do comutador extensível Hyper-V usa o seguinte identificador de objeto (OID) para consultar informações de status personalizadas para o comutador extensível. Esta informação de estado é conhecida como informação de estado da funcionalidade do switch:

OID_SWITCH_FEATURE_STATUS_QUERY
Essa solicitação de método OID é emitida pela borda de protocolo do switch extensível para obter as informações de status do recurso personalizado para uma propriedade de switch especificada.

Após um retorno bem-sucedido dessa solicitação de método OID, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para um buffer. Este buffer contém os seguintes dados:

• Uma estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS que especifica as informações de status do recurso personalizado que devem ser retornadas.

  Observação Para um status de recurso personalizado, o membro FeatureStatusType é definido como NdisSwitchPropertyTypeCustom.

• Uma estrutura NDIS_SWITCH_FEATURE_STATUS_CUSTOM que contém as informações de status sobre uma propriedade personalizada atribuída a uma porta de switch extensível.

  Quando a borda do protocolo do switch extensível emite a solicitação OID_SWITCH_FEATURE_STATUS_QUERY , ela define os membros FeatureStatusCustomBufferLength e FeatureStatusCustomBufferOffset para um local no membro InformationBuffer que a extensão pode usar para retornar as informações de status do recurso.

A extensão de switch extensível deve seguir estas diretrizes quando receber uma solicitação de método OID de OID_SWITCH_FEATURE_STATUS_QUERY:

• A extensão deve lidar com a solicitação OID se ela gerencia um status de recurso de switch extensível personalizado que corresponde ao membro FeatureStatusId da estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS .

• Se a extensão manipula a solicitação do método OID, ela deve retornar as informações de status do recurso que correspondem aos parâmetros especificados pela estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS .

  Se o buffer de status do recurso for muito pequeno, a extensão deverá falhar na solicitação OID com NDIS_STATUS_INVALID_LENGTH. A extensão deve definir o membro DATA.SET_INFORMATION.BytesNeeded na estrutura NDIS_OID_REQUEST ao tamanho mínimo de buffer que é necessário.

  Caso contrário, a extensão deve retornar as informações de status do recurso e concluir a solicitação OID com NDIS_STATUS_SUCCESS.

• Se a extensão não gerenciar o status do recurso de interruptor extensível personalizado, ela deverá chamar NdisFOidRequest para encaminhar a solicitação OID pela pilha de drivers para baixo.

  Para obter mais informações sobre como encaminhar solicitações OID, consulte Filtrando solicitações OID em um driver de filtro NDIS.

Para obter mais informações sobre como definir e registrar informações de status do recurso de comutação, consulte Status do recurso de switch personalizado.