OID_GEN_SUPPORTED_GUIDS

クエリとして、OID_GEN_SUPPORTED_GUIDS OID は、NDIS_GUID型の構造体の配列を返すミニポート ドライバーを要求します。

バージョン情報の

Windows Vista 以降のバージョンの Windows を する
サポート。

NDIS 6.0 以降のミニポート ドライバーの
随意。

NDIS 5.1 ミニポート ドライバーの
随意。

Windows XP の
サポート。

NDIS 5.1 ミニポート ドライバーの
随意。

備考

配列内の各構造体は、カスタム GUID (グローバル一意識別子) をカスタム OID またはミニポート ドライバーが ndisMIndicateStatusEx関数を通じて送信するNDIS_STATUSへのマッピングを指定します。

NDIS_GUID構造体は次のように定義されます。

typedef struct _NDIS_GUID {
    GUID             Guid;
    union {
        NDIS_OID     Oid;
        NDIS_STATUS  Status;
    };
    ULONG            Size;
    ULONG            Flags;
} NDIS_GUID, *PNDIS_GUID;

この構造体のメンバーには、次の情報が含まれています。

guidの
ミニポート ドライバーに定義されているカスタム GUID を指定します。

Oid
Guid がマップされるカスタム OID 指定します。

状態の
Guid マップ先のNDIS_STATUS 指定します。

サイズの
ミニポート ドライバーによって返される配列内の各データ項目のサイズ (バイト単位) を指定します。 fNDIS_GUID_ANSI_STRINGフラグまたはfNDIS_GUID_NDIS_STRINGフラグが設定されている場合、Size は -1 に設定されます。 それ以外の場合、Size は、GUID が表すデータ項目のサイズをバイト単位で指定します。 このメンバーは、fNDIS_GUID_ARRAY フラグが設定されている場合にのみ指定されます。

フラグの
次のフラグを OR 演算子で組み合わせて、GUID が OID またはNDIS_STATUS文字列にマップされているかどうかを示し、GUID に指定されたデータの種類を示すことができます。

fNDIS_GUID_TO_OID
NDIS_GUID構造体が GUID を OID にマップすることを示します。

fNDIS_GUID_TO_STATUS
NDIS_GUID構造体が GUID をNDIS_STATUS文字列にマップすることを示します。

fNDIS_GUID_ANSI_STRING
GUID に null で終わる ANSI 文字列が指定されていることを示します。

fNDIS_GUID_UNICODE_STRING
GUID に Unicode 文字列が指定されていることを示します。

fNDIS_GUID_ARRAY
GUID にデータ項目の配列が指定されていることを示します。 指定した Size は、配列内の各データ項目の長さを示します。

fNDIS_GUID_ALLOW_READ
設定すると、すべてのユーザーがこの GUID を使用して情報を取得することを許可されることを示します。

fNDIS_GUID_ALLOW_WRITE
設定すると、すべてのユーザーがこの GUID を使用して情報を設定することを許可されることを示します。

注 既定では、ミニポート ドライバーによって提供されるカスタム WMI GUID には、管理者特権を持つユーザーのみがアクセスできます。 ミニポート ドライバーがその GUID の読み取りまたは書き込み操作をサポートしている場合、管理者特権を持つユーザーは、常にカスタム GUID の読み取りまたは書き込みを行うことができます。 fNDIS_GUID_ALLOW_READフラグとfNDIS_GUID_ALLOW_WRITEフラグを設定して、すべてのユーザーがカスタム GUID にアクセスできるようにします。

ミニポート ドライバーによって登録されているすべてのカスタム GUID は、fNDIS_GUID_TO_OIDまたはfNDIS_GUID_TO_STATUS (両方を設定しない) を設定する必要があることに注意してください。 その他のフラグはすべて、該当する OR 演算子を使用して結合できます。

次の例では、NDIS_GUID構造体によって GUID がOID_802_3_MULTICAST_LISTにマップされます。

NDIS_GUID    NdisGuid = {{0x44795701, 0xa61b, 0x11d0, 0x8d, 0xd4,
                          0x00, 0xc0, 0x4f, 0xc3,
                          0x35, 0x8c},
                          OID_802_3_MULTICAST_LIST,
                          6,
                          fNDIS_GUID_TO_OID | fNDIS_GUID_ARRAY};

GUID は、情報を取得または設定するために Windows Management Instrumentation (WMI) によって使用される識別子です。 NDIS は、WMI によって送信された GUID を NDIS ドライバーにインターセプトし、GUID を OID にマップし、OID をドライバーに送信します。 ドライバーは NDIS にデータ項目を返し、WMI にデータを返します。

NDIS は、WMI によって認識される GUID に NIC の状態の変更も変換します。 ミニポート ドライバーは、NdisMIndicateStatusEx 関数を使用して NIC の状態の変更を報告するとき、NDIS は、NDIS が WMI に送信する GUID にミニポート ドライバーによって示されるNDIS_STATUSを変換します。

ミニポート ドライバーは、通関 GUID をサポートしている場合は、OID_GEN_SUPPORTED_GUIDSをサポートする必要があります。 この OID は、カスタム OID またはNDIS_STATUS文字列へのカスタム GUID のマッピングを NDIS に返します。 OID_GEN_SUPPORTED_GUIDSを使用してミニポート ドライバーに対してクエリを実行した後、NDIS はミニポート ドライバーのカスタム GUID を WMI に登録します。

必要条件

ヘッダ	Ntddndis.h (Ndis.h を含む)

関連項目

NdisMIndicateStatusExの