Compartilhar via

Gerenciando informações de status do recurso de comutador personalizado

  • Artigo

A interface do comutador extensível do Hyper-V usa o OID (identificador de objeto) a seguir para consultar informações de status personalizadas para o comutador extensível. Essas informações de status são conhecidas como informações de status de recurso de comutador:

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

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

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

    Nota Para um recurso personalizado status, o membro FeatureStatusType é definido como NdisSwitchPropertyTypeCustom.

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

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

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

  • A extensão deverá manipular a solicitação OID se gerenciar um recurso de comutador extensível personalizado status que corresponda ao membro FeatureStatusId da estrutura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS.

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

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

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

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

    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 o recurso de alternância status informações, consulte Status do Recurso de Alternância Personalizada.