DD_DXAPI_OPENSURFACE コントロール コード

ビデオ キャプチャ ドライバーは、DxApi 関数の dwFunctionNum パラメーターで DD_DXAPI_OPENSURFACE を渡して、ドライバーがサーフェス オブジェクトを必要とすることをカーネル モードのビデオ トランスポートに通知します。

入力パラメーター

• lpvInBuffer
  DirectDrawSurface オブジェクト情報を格納する DDOPENSURFACEIN 構造体へのポインター。

出力パラメーター

• lpvOutBuffer
  新しい DirectDrawSurface ハンドル情報を格納する DDOPENSURFACEOUT 構造体へのポインター。

解説

オブジェクトは、DDOPENSURFACEIN の dwSurfaceHandle メンバー (ユーザー モードから渡されるハンドル) によって指定されます。 DDOPENSURFACEIN の hDirectDraw メンバーは、サーフェスが関連付けられている DirectDraw オブジェクトを指定します。 このドライバーでは、ユーザー モード、全画面表示のコマンド プロンプト、またはモードの変更でサーフェスが解放されたために使用できなくなったときに呼び出すコールバックも指定する必要があります。 pContext メンバーには、pfnSurfaceClose コールバック関数が呼び出された場合に渡される値が格納されます。

DDOPENSURFACEOUT の ddRVal メンバーが DD_OK に設定されている場合、この関数識別子からの出力は、新しいサーフェス ハンドルになります。 この新しいハンドルは、このサーフェスを参照する後続のすべての呼び出しで使用する必要があります。

この関数識別子は、PASSIVE_LEVEL からのみ呼び出すことができます。

要件

ヘッダー ファイル: Ddkmapi.h (Ddkmapi.h を含む)

関連項目

DDOPENSURFACEIN

DDOPENSURFACEOUT

NotifyCallback