Platform SDK: DirectX

DDEnumCallbackEx

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

BOOL WINAPI DDEnumCallbackEx(
  GUID FAR *lpGUID,    
  LPSTR     lpDriverDescription, 
  LPSTR     lpDriverName,        
  LPVOID    lpContext,           
  HMONITOR  hm        
);

パラメータ

lpGUID
DirectDraw オブジェクトのユニーク識別子のアドレス。
lpDriverDescription
ドライバ記述を含む文字列のアドレス。
lpDriverName
ドライバ名を含む文字列のアドレス。
lpContext
関数を呼び出すごとにコールバック関数に渡されるアプリケーション定義構造体のアドレス。
hm
列挙する DirectDraw オブジェクトに関連付けられたモニタへのハンドル。列挙する DirectDraw オブジェクトがプライマリ デバイス、非ディスプレイ デバイス (2D 能力がない 3D アクセラレータなど)、またはデスクトップにアタッチされないデバイスである場合、このパラメータは NULL となる。

戻り値

コールバック関数は、ゼロ以外の値を返して列挙を続行する。

コールバック関数は、ゼロを返して列挙を停止する。

注意

DirectDrawEnumerateEx 関数が完了すると、GUID へのポインタは有効ではなくなる。ポインタではなく、GUID 構造体そのもののコピーを保存しなければならない。そうでないと、DirectDrawCreate 関数が失敗する。

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

UNICODE が定義されると、文字列値は LPSTR ではなく LPWSTR 型として返される。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。
  インポート ライブラリ : ユーザー定義。

参照

MultiMon システムにおけるデバイスの列挙マルチモニタ システム