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