WDF_OBJECT_CONTEXT_TYPE_INFO 構造体 (wdfobject.h)
[KMDF と UMDF に適用]
WDF_OBJECT_CONTEXT_TYPE_INFO構造体は、フレームワーク オブジェクトのドライバー定義コンテキスト メモリを記述します。
構文
typedef struct _WDF_OBJECT_CONTEXT_TYPE_INFO {
ULONG Size;
LPCSTR ContextName;
size_t ContextSize;
PCWDF_OBJECT_CONTEXT_TYPE_INFO UniqueType;
PFN_GET_UNIQUE_CONTEXT_TYPE EvtDriverGetUniqueContextType;
} WDF_OBJECT_CONTEXT_TYPE_INFO, *PWDF_OBJECT_CONTEXT_TYPE_INFO;
メンバー
Size
この構造体のサイズ (バイト単位)。
ContextName
オブジェクトのコンテキスト情報を含むドライバー定義構造体の名前を表す引用符で囲まれた文字列。
ContextSize
ContextName メンバーが指定する構造体のサイズ (バイト単位)。 フレームワークは、オブジェクトを作成するときに、この構造体の領域を割り当てます。 WDF_OBJECT_ATTRIBUTES構造体の ContextSizeOverride メンバーが 0 以外の場合、その値は ContextSize メンバーの値をオーバーライドします。
UniqueType
内部使用です。
EvtDriverGetUniqueContextType
内部使用です。
解説
フレームワークは、オブジェクト インスタンスごとに、ContextSize メンバーの値またはWDF_OBJECT_ATTRIBUTES構造体のContextSizeOverride メンバーの値に基づくサイズのコンテキスト メモリを割り当てます。
WDF_OBJECT_CONTEXT_TYPE_INFO構造体を作成して初期化するには、ドライバーで WDF_DECLARE_CONTEXT_TYPE マクロまたは WDF_DECLARE_CONTEXT_TYPE_WITH_NAME マクロを使用する必要があります。
この構造体へのポインターをWDF_OBJECT_ATTRIBUTES構造体に挿入するには、ドライバーで WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE マクロを使用する必要があります。
これらのマクロの使用方法の詳細については、「 Framework オブジェクト コンテキスト空間」を参照してください。
要件
要件 | 値 |
---|---|
最小 KMDF バージョン | 1.0 |
最小 UMDF バージョン | 2.0 |
Header | wdfobject.h (Wdf.h を含む) |