ホーム › Graphics.DirectDraw › LPDDENUMCALLBACKEXW

LPDDENUMCALLBACKEXW

コールバック

シグネチャ

BOOL LPDDENUMCALLBACKEXW(
    GUID* param0,
    LPWSTR param1,
    LPWSTR param2,
    void* param3,
    HMONITOR param4
);

パラメーター

フィールド	型	説明
param0	GUID*	DirectDraw オブジェクトの一意の識別子へのポインターです。
param1	LPWSTR	ドライバー名を格納する文字列のアドレスです。
param2	LPWSTR	ドライバーの説明を格納する文字列のアドレスです。
param3	void*	この関数が呼び出されるたびにコールバック関数へ渡される、アプリケーション定義の構造体へのポインターです。
param4	HMONITOR	列挙された DirectDraw オブジェクトに関連付けられているモニターのハンドルです。列挙された DirectDraw オブジェクトがプライマリデバイス、非表示デバイス (2-D 機能を持たない 3-D アクセラレーターなど)、またはデスクトップに接続されていないデバイスのものである場合、このパラメーターは NULL になります。

公式ドキュメント

DDEnumCallbackEx 関数は、DirectDrawEnumerateEx 関数のためのアプリケーション定義のコールバック関数です。

戻り値

列挙を続行する場合、コールバック関数は 0 以外の値を返します。

列挙を停止する場合は 0 を返します。

解説(Remarks)

DirectDrawEnumerateEx 関数の完了後は、lpGUID が指す GUID へのポインターは無効になります。ポインターではなく GUID 構造体自体のコピーを保存する必要があります。保存しない場合、DirectDrawCreateEx 関数は失敗します。

LPDDENUMCALLBACKEX データ型を使用すると、このコールバック関数へのポインターを格納できる変数を宣言できます。

UNICODE が定義されている場合、文字列値は LPSTR ではなく LPWSTR 型で返されます。

メモ

ddraw.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして LPDDENUMCALLBACKEX を定義しています。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させて使用すると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)