WNDOBJ_cEnumStart関数 (winddi.h)

WNDOBJ_cEnumStart関数は、ウィンドウの可視領域の四角形の列挙のパラメーターを設定するコールバック関数です。

構文

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

パラメーター

pwo

EngCreateWnd の呼び出しによって作成された WNDOBJ 構造体へのポインター。

iType

WNDOBJ_bEnumによって返される構造体の型を指定します。このパラメーターはCT_RECTANGLESできます。つまり、領域は四角形のリストとして列挙されます。

iDirection

四角形が返される順序を決定します。この順序は、重複する DrvBitBlt が同じサーフェスで実行されている場合に不可欠な場合があります。注文がデバイスドライバーに関連しない場合は、CD_ANYを指定する必要があります。これにより、GDI は複雑な領域の列挙を最適化できます。このパラメーターには、次のいずれかの値を指定できます。

値	意味
CD_ANY	GDI に便利な任意の順序。
CD_LEFTDOWN	右から左、上から下へ。
CD_LEFTUP	右から左、下から上へ。
CD_LEFTWARDS	左から右、垂直方向は定義されていません。
CD_RIGHTDOWN	左から右、上から下へ。
CD_RIGHTUP	左から右、下から上へ。
CD_UPWARDS	下から上、水平方向は定義されていません。

cLimit

ドライバーがキャッシュに関心があるオブジェクトの数を示します。これは、GDI がこの関数の戻り値を計算している間に四角形のカウントを停止するタイミングを決定するためにのみ使用されます。 cLimit が 0 の場合、カウントは行われません。

戻り値

戻り値は、この値が cLimit 以下の場合に列挙されるオブジェクトの数です。カウントが cLimit より大きい場合、戻り値は0xFFFFFFFF。

注釈

列挙は、この関数をもう一度呼び出すことによって再起動できます。

WNDOBJ_cEnumStart は、次の場合にのみ呼び出す必要があります。

EngCreateWnd 関数の GDI に提供されるドライバーコールバック関数、または WNDOBJ が指定されているグラフィックス DDI 関数のコンテキスト。
呼び出し元スレッドにデバイスロックがある場合は、クライアント領域の変更が発生しないようにします。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	winddi.h (Winddi.h を含む)
Library	Win32k.lib
[DLL]	Win32k.sys