ホーム › Graphics.DirectDraw › LPDDENUMCALLBACKEXA

LPDDENUMCALLBACKEXA

コールバック

シグネチャ

BOOL LPDDENUMCALLBACKEXA(
    GUID* param0,
    LPSTR param1,
    LPSTR param2,
    void* param3,
    HMONITOR param4
);

パラメーター

フィールド	型	説明
param0	GUID*	DirectDraw オブジェクトの一意の識別子へのポインターです。
param1	LPSTR	ドライバー名を格納する文字列のアドレスです。
param2	LPSTR	ドライバーの説明を格納する文字列のアドレスです。
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)