IDvdInfo2::GetCurrentUOPS メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
メソッドは GetCurrentUOPS
、現在のディスクの場所に対してコンテンツ作成者が明示的に無効にしたナビゲーション コマンド (存在する場合) を示すフラグのセットを取得します。
構文
HRESULT GetCurrentUOPS(
[out] ULONG *pulUOPs
);
パラメーター
[out] pulUOPs
ビットごとの VALID_UOP_FLAG 値を受け取ります。 各ビットは、ユーザー操作 (UOP) の状態 (有効または無効) を表します。 ビットが設定されている場合、そのユーザー操作は禁止されます。 「解説」を参照してください。
戻り値
次のいずれかの HRESULT 値を 返します。
リターン コード | 説明 |
---|---|
|
正常終了しました。 |
|
pulUOP は有効なポインターではありません。 |
注釈
DVD 作成者は、ディスク上のほぼすべての場所に UOP コマンドを挿入して、現在の DVD ドメイン内で許可されるナビゲーション コマンドを禁止できます。 言い換えると、UOP コマンドを使用すると、ディスク作成者は通常のナビゲーション権限をオーバーライドできます。
DVD ナビゲーターはコマンドを続行する前にすべての UOP アクセス許可を自動的にチェックし、現在の UOP でコマンドが無効な場合は任意のメソッドからVFW_E_DVD_OPERATION_INHIBITEDを返すので、通常は、このメソッドを使用する必要はありません。 アプリケーションで現在の UOP アクセス許可自体を追跡する必要がある場合は、現在の UOP アクセス許可が必要なときにいつでも を呼び出 GetCurrentUOPS
すか、メッセージ ループで EC_DVD_VALID_UOPS_CHANGE イベント通知を処理し、 lParam1 パラメーターから UOP 情報を取得できます。 後者のアプローチは、一般に、より効率的です。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | strmif.h (Dshow.h を含む) |
Library | Strmiids.lib |