IDvdControl2::SetGPRM メソッド (strmif.h)

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

メソッドは SetGPRM 、一般的なパラメーター レジスタ値を設定します。

構文

HRESULT SetGPRM(
  [in]  ULONG   ulIndex,
  [in]  WORD    wValue,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

パラメーター

[in] ulIndex

インデックスを登録します。には、0 から 15 までの値を指定できます。

[in] wValue

指定したレジスタに含まれる 16 ビット値。

[in] dwFlags

コマンドを同期する方法を指定する 、DVD_CMD_FLAGS 列挙からの 1 つ以上のフラグのビットごとの OR。

[out] ppCmd

DVD コマンドの同期に使用できる IDvdCmd オブジェクトへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。 このパラメーターは、NULL でもかまいません。 詳細については、「 DVD コマンドの同期」を参照してください。

戻り値

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

リターン コード 説明
S_OK
正常終了しました。
E_INVALIDARG
ulIndex パラメーターが 15 より大きいか、他の入力パラメーターが無効です。

注釈

DVD ディスクは、一般的なパラメーター レジスタを使用して、さまざまな種類の情報を格納します。 これらのレジスタの 1 つ以上を手動で設定することで、アプリケーションで特定のカスタム機能を提供できる場合があります。 これは高度なコマンドであり、DVD 仕様を十分に理解していない限り使用しないでください。

次の表は、このメソッド名が対応する Annex J コマンド名と、このメソッドが有効なドメインを示しています。

Annex J コマンド名 有効なドメイン
なし すべて

要件

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

こちらもご覧ください

DVD アプリケーション

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

IDvdControl2 インターフェイス

IDvdInfo2::GetAllGPRMs