CLIPOBJ_bEnum関数 (winddi.h)

CLIPOBJ_bEnum関数は、指定したクリップ領域から四角形のバッチを列挙します。CLIPOBJ_cEnumStart の前の呼び出しによって列挙の順序が決まります。

構文

ENGAPI BOOL CLIPOBJ_bEnum(
  [in]  CLIPOBJ *pco,
  [in]  ULONG   cj,
  [out] ULONG   *pul
);

パラメーター

[in] pco

列挙するクリップ領域を記述する CLIPOBJ 構造体へのポインター。

[in] cj

pv が指すバッファーのサイズをバイト単位で指定 します。

[out] pul

ENUMRECTS 構造体内のクリップ領域に関するデータを受信するバッファーへのポインター。

戻り値

ドライバーがこの関数をもう一度呼び出してより多くの列挙データを呼び出す必要がある場合、戻り値は TRUE 、列挙が完了した場合は FALSE です。 CLIPOBJ_bEnumは、クリッピング四角形の数が 0 の TRUE を返すことができます。 このような場合、ドライバーは何も行わずに CLIPOBJ_bEnum をもう一度呼び出す必要があります。

注釈

この関数を呼び出すためのループ構造は次のとおりです。

do {
    bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
    for (i = 0; i < buffer.c; i++) {
        .
        .
        .
    }
} while (bMore);

バッファーに書き込まれたオブジェクトの数は、バッファー自体に書き込まれます。

要件

こちらもご覧ください

CLIPOBJ

CLIPOBJ_cEnumStart

ENUMRECTS