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 キーワード値を読み取ることができます。
ミニポート ドライバーが初期化されたときに NdisMRegisterMiniportDriver 関数によって返された NDIS ハンドルを使用して、NdisOpenConfigurationEx を呼び出します。 NdisOpenConfigurationEx の呼び出しの詳細については、「NDIS 6.0 ミニポート ドライバーのレジストリの読み取り」を参照してください。
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 を含む) |