ホーム › Graphics.DirectDraw › PDX_SETSTATE

PDX_SETSTATE

コールバック

シグネチャ

DWORD PDX_SETSTATE(
    void* param0,
    DDSETSTATEININFO* param1,
    DDSETSTATEOUTINFO* param2
);

パラメーター

フィールド	型	説明
param0	void*	ミニポートドライバーのデバイス拡張を指します。
param1	DDSETSTATEININFO*	サーフェスと VPE オブジェクトの情報を格納する DDSETSTATEININFO 構造体を指すポインターです。
param2	DDSETSTATEOUTINFO*	ハードウェアビデオポートの状態情報を格納する DDSETSTATEOUTINFO 構造体を指すポインターです。

公式ドキュメント

DxSetState コールバック関数は、ビデオミニポートドライバーのクライアントが bob モードから weave モードへ、またはその逆へ切り替えることを決定したときに呼び出されます。

戻り値

DxSetState は、成功した場合は DX_OK を返します。失敗した場合は、次のいずれかのエラー値を返します。

解説(Remarks)

渡されるサーフェスデータには、新しい状態が格納されています。新しい状態がサポートされていない場合、ビデオミニポートドライバーはこの呼び出しを失敗させる必要があります。

新しい状態によってデバイスがハードウェア自動フリップからソフトウェア自動フリップへ戻る必要がある場合、ビデオミニポートドライバーは SetStateOutInfo にある DDSETSTATEOUTINFO 構造体のメンバーを次のように設定する必要があります。

dwSoftwareAutoflip メンバーを 1 に設定します。
dwSurfaceIndex メンバーを、ハードウェアビデオポートのデータを受け取るサーフェスの自動フリップリスト内での現在の位置に設定します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)