Statusinformatie over aangepaste switchfuncties beheren

De Hyper-V uitbreidbare switchinterface gebruikt de volgende object-id (OID) om aangepaste statusinformatie op te vragen voor de uitbreidbare switch. Deze statusinformatie is bekend als schakelkenmerkstatus informatie:

OID_SWITCH_FEATURE_STATUS_QUERY
Deze OID-methodeaanvraag wordt uitgegeven door de protocolrand van de uitbreidbare switch om de informatie over de aangepaste functiestatus voor een opgegeven switcheigenschap te verkrijgen.

Na een geslaagde terugkeer van deze OID-methodeaanvraag bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een buffer. Deze buffer bevat de volgende gegevens:

• Een NDIS_SWITCH_FEATURE_STATUS_PARAMETERS structuur die de informatie over de aangepaste functiestatus aangeeft die moet worden geretourneerd.

  Opmerking Voor een aangepaste functiestatus is het lid FeatureStatusType ingesteld op NdisSwitchPropertyTypeCustom-.

• Een NDIS_SWITCH_FEATURE_STATUS_CUSTOM structuur met de statusinformatie over een aangepaste eigenschap die is toegewezen aan een uitbreidbare switchpoort.

  Wanneer de protocolrand van de uitbreidbare switch de OID_SWITCH_FEATURE_STATUS_QUERY-aanvraag maakt, stelt het de FeatureStatusCustomBufferLength en FeatureStatusCustomBufferOffset-leden in op een locatie in het InformationBuffer-lid die de extensie kan gebruiken om de functiestatusinformatie terug te geven.

De uitbreiding voor uitbreidbare switch moet deze richtlijnen volgen wanneer er een OID-methodeaanvraag van OID_SWITCH_FEATURE_STATUS_QUERYwordt ontvangen:

• De extensie moet de OID-aanvraag verwerken als deze een aangepaste uitbreidbare switchfunctiestatus beheert die overeenkomt met de FeatureStatusId lid van de NDIS_SWITCH_FEATURE_STATUS_PARAMETERS-structuur.

• Als de extensie de aanvraag van de OID-methode afhandelt, moet deze informatie over de functiestatus retourneren die overeenkomt met de parameters die zijn opgegeven door de NDIS_SWITCH_FEATURE_STATUS_PARAMETERS structuur.

  Als de functiestatusbuffer te klein is, moet de extensie een OID-aanvraag laten mislukken met NDIS_STATUS_INVALID_LENGTH. De extensie moet het lid DATA.SET_INFORMATION.BytesNeeded in de NDIS_OID_REQUEST structuur instellen op de minimale buffergrootte die vereist is.

  Anders moet de extensie de informatie over de functiestatus retourneren en de OID-aanvraag voltooien met NDIS_STATUS_SUCCESS.

• Als de extensie de status van de aangepaste uitbreidbare switchfunctie niet beheert, moet deze NdisFOidRequest aanroepen om de OID-aanvraag omlaag te sturen naar de stack van het uitbreidbare switchstuurprogramma.

  Zie Filteren van OID-aanvragen in een NDIS-filterstuurprogrammavoor meer informatie over het doorsturen van OID-aanvragen.

Zie Aangepaste switchfunctiestatusvoor meer informatie over het definiëren en registreren van functiestatusinformatie.