OID_NDK_SET_STATE

W ramach ustawionego żądania sterowniki NDIS i nadmiernie używają identyfikatora OID OID_NDK_SET_STATE, aby ustawić stan funkcji NDK karty miniport.

Sterowniki NDIS 6.30 i nowsze miniport, które zapewniają usługi NDK, muszą obsługiwać ten identyfikator OID. W przeciwnym razie ten OID jest opcjonalny.

Uwagi

NDIS wystawia ten identyfikator OID z elementem członkowskim InformationBuffer struktury NDIS_OID_REQUEST wskazującą element logiczny i InformationBufferLength równy sizeof(BOOLEAN).

• Jeśli wartość BOOLEAN ma wartość TRUE , a wartość słowa kluczowego *NetworkDirect jest niezerowa, należy włączyć funkcję NDK karty miniportu.

  Sterownik miniportu może odczytać wartość słowa kluczowego *NetworkDirect , wykonując następujące czynności:

  1. Wywołaj element NdisOpenConfigurationEx za pomocą uchwytu NDIS, że funkcja NdisMRegisterMiniportDriver zwrócona podczas inicjowania sterownika miniportu. Aby uzyskać więcej informacji na temat wywoływania interfejsu NdisOpenConfigurationEx, zobacz Odczytywanie rejestru w sterowniku NDIS 6.0 Miniport.

  2. Wywołaj metodę NdisReadConfiguration, przekazując:

     • "*NetworkDirect" dla parametru słowa kluczowego

     • NdisParameterInteger parametru ParameterType

• Jeśli wartość LOGICZNA to FALSE, funkcja NDK karty miniport musi być wyłączona.

Aby włączyć lub wyłączyć funkcję NDK, funkcja wywołania zwrotnego miniportu sterownika MiniportOidRequest powinna wykonać kroki opisane w temacie Włączanie i wyłączanie funkcji NDK.

Nuta Sterownik miniportu obsługujący protokół NDK nigdy nie może wywoływać NdisMNetPnPEvent z kontekstu funkcji MiniportOidRequest , ponieważ może to spowodować zakleszczenie. Zamiast tego należy wywołać element roboczy NdisMNetPnPEvent z innego kontekstu lub kolejki elementu roboczego.

Funkcja Miniportu miniportu sterownika MiniportOidRequest z obsługą NDK musi zwrócić STATUS_SUCCESS dla żądania identyfikatora OID OID_NDK_SET_STATE, chyba że wystąpi awaria. Sterownik nie może zwrócić NDIS_STATUS_PENDING.

Wymagania

Zobacz także

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER