次の方法で共有

OID_NDK_SET_STATE

  • [アーティクル]

NDIS および上部のドライバーは、Set 要求として、OID_NDK_SET_STATE OID を使用して、ミニポート アダプターの NDK 機能の状態を設定します。

NDK サービスを提供する NDIS 6.30 以降のミニポート ドライバーは、この OID をサポートする必要があります。 それ以外の場合は、この OID は省略可能です。

解説

NDIS は、BOOLEAN を指す NDIS_OID_REQUEST 構造体の InformationBuffer メンバーと sizeof(BOOLEAN) と等しい InformationBufferLength メンバーでこの OID を発行します。

  • BOOLEAN 値が TRUE で、*NetworkDirect キーワード値が 0 以外の場合は、ミニポート アダプターの NDK 機能を有効にする必要があります。

    ミニポート ドライバーは、次の操作を行うことで、*NetworkDirect キーワード値を読み取ることができます。

    1. ミニポート ドライバーが初期化されたときに NdisMRegisterMiniportDriver 関数によって返された NDIS ハンドルを使用して、NdisOpenConfigurationEx を呼び出します。 NdisOpenConfigurationEx の呼び出しの詳細については、「NDIS 6.0 ミニポート ドライバーのレジストリの読み取り」を参照してください。

    2. NdisReadConfiguration を呼び出し、以下に渡します。

      • Keyword パラメーターの場合は "*NetworkDirect"

      • ParameterType パラメーターの場合は NdisParameterInteger

  • BOOLEAN 値が FALSE の場合、ミニポート アダプターの NDK 機能を無効にする必要があります。

NDK 機能を有効または無効にするには、ミニポート ドライバーの MiniportOidRequest コールバック関数は、「NDK 機能の有効化と無効化」の手順に従う必要があります。

注 NDK 対応ミニポート ドライバーは、デッドロックが発生する可能性があるため、その MiniportOidRequest 関数のコンテキストからは NdisMNetPnPEvent を呼び出さないでください。 代わりに、他のコンテキストから NdisMNetPnPEvent を呼び出すか、作業項目をキューに登録します。

NDK 対応ミニポート ドライバーの MiniportOidRequest 関数は、エラーが発生しない限り、OID_NDK_SET_STATE OID 要求に STATUS_SUCCESS を返す必要があります。 ドライバーは NDIS_STATUS_PENDING を返すことはできません。

要件

サポートされている最小のクライアント

サポートなし

サポートされている最小のサーバー

Windows Server 2012

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE