LPDIRECTDRAWENUMERATEEXA
コールバックシグネチャ
HRESULT LPDIRECTDRAWENUMERATEEXA(
LPDDENUMCALLBACKEXA lpCallback,
void* lpContext,
DWORD dwFlags
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| lpCallback | LPDDENUMCALLBACKEXA | 列挙された DirectDraw 対応のハードウェア アブストラクション レイヤー (HAL) ごとに、その説明を伴って呼び出される DDEnumCallbackEx 関数のアドレスです。 |
| lpContext | void* | 列挙コールバック関数が呼び出されるたびに渡される、アプリケーション定義の値のアドレスです。 |
| dwFlags | DWORD | 列挙の範囲を指定するフラグです。このパラメーターには 0、または次のフラグの組み合わせを指定できます。値が 0 の場合、この関数はプライマリ ディスプレイ デバイスのみを列挙します。 DDENUM_ATTACHEDSECONDARYDEVICESプライマリ デバイスと、デスクトップに接続されているすべてのディスプレイ デバイスを列挙します。 DDENUM_DETACHEDSECONDARYDEVICESプライマリ デバイスと、デスクトップに接続されていないすべてのディスプレイ デバイスを列挙します。 DDENUM_NONDISPLAYDEVICESプライマリ デバイスと、2-D 機能を持たない 3-D アクセラレーターなどの非ディスプレイ デバイスを列挙します。 |
公式ドキュメント
コンピューターにインストールされているすべての DirectDraw デバイスを列挙します。NULL のエントリーは、常に GDI と共有されるプライマリ ディスプレイ デバイスを示します。
戻り値
関数が成功した場合、戻り値は DD_OK です。
失敗した場合、関数は DDERR_INVALIDPARAMS を返します。
解説(Remarks)
複数のモニターを備えたコンピューターでは、DirectDrawEnumerateEx は複数のディスプレイ デバイスを列挙します。
Ddraw.dll に明示的にリンクするには、LoadLibrary を使用する必要があります。DirectDrawEnumerateEx 関数のアドレスを取得するには、プロセス名の文字列 "DirectDrawEnumerateExA" (ANSI) または "DirectDrawEnumerateExW" (Unicode) を指定して、Win32 関数の GetProcAddress を呼び出します。
ddraw.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして DirectDrawEnumerateEx を定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させて使用すると、不一致が生じてコンパイル エラーや実行時エラーの原因になることがあります。詳細については、「関数プロトタイプの規則」を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)