IDvdInfo2::GetAllSPRMs メソッド (strmif.h)

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

GetAllSPRMs メソッドは、すべてのシステム パラメーター レジスタ (SPRM) の現在の内容を取得します。

構文

HRESULT GetAllSPRMs(
  [out] SPRMARRAY *pRegisterArray
);

パラメーター

[out] pRegisterArray

SPRM の配列のアドレスを受け取る SPRMARRAY 型の配列へのポインター。

戻り値

次のいずれかの HRESULT 値を 返します。

リターン コード 説明
S_OK
 正常終了しました。
E_POINTER
 引数が無効です。

解説

24 個の SPRM は、現在の言語、サブ画像、およびその他のナビゲーション データに関する情報を保持するために使用されます。

メモ プレーヤー アプリケーションは、標準のナビゲーション機能のためにこれらの読み取り専用レジスタにアクセスする必要はありません。 これらのレジスタを効果的に使用するには、このドキュメントに記載されているよりも DVD ナビゲーション コマンドに関するより詳細な知識が必要になる可能性があります。 次の表に、各レジスタの内容を示します。 単語内のビットは、b0 (下位ビット) から b15 (上位ビット) までと呼ばれます。
 
登録 内容
0 ISO-639 言語コード (2 つの小文字の ASCII 文字)。 既定値は未定義です。
1 下位 4 ビット (b0 から b3) には、オーディオ ストリーム番号 (0 から 7) または 15 (なし) が含まれます。 既定値は 15 です。
2 下位 6 ビット (b0 から b5) には、サブPICTURE ストリーム番号 (0 から 31) または 62 (なし) または 63 (強制サブPICTURE のダミー ストリーム) が含まれます。 7 番目のビット (b6) には、サブ画像の表示フラグが含まれています (0 = サブ画像を表示しません)。 既定値は 62 です。
3 低 4 ビット (b0-b3) には、角度番号 (1 から 9) が含まれます。 既定値は 1 です。
4 下位 7 ビット (b0 から b6) にはタイトル番号 (1 から 99) が含まれます。 既定値は 1 です。
5 下位 7 ビット (b0-b6) には、現在の VTS (1 から 99) 内のタイトル番号が含まれています。 既定値は 1 です。
6 下位 15 ビット (b0 から b14) には、現在のタイトル (1 から 32767) に PGC 番号が含まれています。 既定値は未定義です。
7 下位 10 ビット (b0 から b9) には、チャプター番号 (1 から 99) が含まれます。 既定値は 1 です。 title がone_sequential_PGC_titleされていない限り、値は未定義です。
8 上位 6 ビット (b10-b15) にはボタン番号 (1 ~ 36) が含まれます。 既定値は 1024 (ボタン 1) です。
9 タイマー数 (秒単位) (0 から 65535)。 既定値は 0 です。
10 下位 15 ビット (b0 から b14) には、現在のタイトル (1 から 32767) に PGC 番号が含まれています。 既定値は未定義です。
11 6つのフラグ(b2:ch2をch1に混合し、b3:ch3をch1に混合し、b4:ch1にch4を混合し、b10はch0に、b11はch3をch0に混合し、b12はch4をch0にミックスする)。 フラグ値 0 は、混在しないことを意味します。 すべてのフラグの既定値は 0 です。 カラオケ ストリームを再生していない場合は未定義の値。
12 ISO-3166 の国/地域コード (2 つの大文字の ASCII 文字) または 65535 (指定されていません)。 既定値は未定義です。
13 下位 4 ビット (b0-b3) には、親レベル (1 から 8) または 15 (なし) が含まれます。 既定値は未定義です。
14 b8-b9 には、現在のビデオ出力モード (0 = 標準 [4:3 または 16:9]、1 = panscan、2 = レターボックス) が含まれています。 b10-b11 には優先表示モード (0 = 4:3、3 = 16:9) が含まれています。 既定値は未定義です。
15 9 つのフラグ (b2: SDDS カラオケ、b3: DTS カラオケ、b4: MPEG カラオケ、b6: Dolby Digital カラオケ、b7: PCM カラオケ、b10: SDDS 再生、b11: DTS 再生、b12: MPEG 再生、b14: Dolby Digital 再生)。 フラグ値 0 は不可を意味し、1 は可能を意味します。 既定値は未定義です。
16 ISO-639 言語コード (2 つの小文字の ASCII 文字) または 65535 (指定されていません)。 既定値は 65535 です。
17 言語拡張コード (0 = 指定なし、1 = 通常のオーディオ、2 = 視覚障のオーディオ、3 = ディレクター コメント #1、4 = ディレクター コメント #2)。 既定値は 0 です。
18 ISO-639 言語コード (2 つの小文字の ASCII 文字) または 65535 (指定されていません)。 既定値は 65535 です。
19 言語拡張コード (0 = 指定なし、1 = 標準字幕、2 = 大きな字幕、3 = 子の字幕、5 = 標準クローズド キャプション、6 = 大きいクローズド キャプション、7 = 子のクローズド キャプション、9 = 強制字幕、13 = ディレクター コメント、14 = 大きいディレクター コメント、15 = 子のディレクター コメント)。 既定値は 0 です。
20 下位 8 ビット (b0-b7) には、リージョン コード (1 から 8) が含まれます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

DVD アプリケーション

エラーコードと成功コード

IDvdInfo2 インターフェイス