CMediaControl.GetIDsOfNames メソッド

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

1 つのメンバー関数とパラメーターの省略可能なセットを、対応する整数ディスパッチ識別子 (DISPID) のセットにマップします。これは、 CMediaControl::Invoke メンバー関数の後続の呼び出し時に使用できます。

構文

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

パラメーター

riid

参照識別子。 将来利用するために予約されています。 NULL にする必要があります。

rgszNames

マップする名前の渡された配列へのポインターのアドレス。

Cname

マッピングされる名前のカウント。

lcid

名前を解釈するロケール コンテキスト。

rgdispid

呼び出し元によって割り当てられた配列へのポインター。各要素には 、rgszNames 配列で渡された名前のいずれかに対応する ID が含まれています。 最初の要素はメンバー名を表します。後続の要素は、メンバーの各パラメーターを表します。

戻り値

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

リターン コード	説明
DISP_E_UNKNOWN_CLSID	CLSID が認識されませんでした。
DISP_E_UNKNOWNNAME	1 つ以上の名前が不明です。 返される DISPID には、不明な名前に対応する各エントリのDISPID_UNKNOWNが含まれています。
E_OUTOFMEMORY	メモリが不足しています。
S_OK	成功しました。

要件

要件	値
ヘッダー	Ctlutil.h (Streams.h を含む)
ライブラリ	Strmbase.lib (小売ビルド); Strmbasd.lib (デバッグ ビルド)

関連項目

CMediaControl クラス