次の方法で共有

ISectionList::Initialize

  • [アーティクル]

Initialize メソッドはオブジェクトを初期化する。このメソッドは、オブジェクトを作成した直後に、1 回呼び出す必要がある。IMpeg2Data::GetSection メソッドおよび IMpeg2Data::GetTable メソッドが内部でこのメソッドを呼び出すため、通常、アプリケーションはこのメソッドを呼び出さない。

構文

  HRESULT Initialize(
  MPEG_REQUEST_TYPE  requestType,
  IMpeg2Data*  pMpeg2Data,
  PMPEG_CONTEXT  pContext,
  PID  pid,
  TID  tid,
  PMPEG2_FILTER  pFilter,
  DWORD  timeout,
  HANDLE  hDoneEvent
);

パラメータ

requestType

[in]  要求のタイプを MPEG_REQUEST_TYPE 値として指定する。

pMpeg2Data

[in]  MPEG-2 セクションおよびテーブル フィルタの IMpeg2Data インターフェイスへのポインタ。

pContext

[in]  MPEG_CONTEXT 構造体へのポインタ。この構造体は MPEG-2 ソースを示す。

pid

[in]  トランスポート ストリーム内の要求するパケットを示すパケット識別子 (PID) を指定する。

tid

[in]  取得するテーブル セクションを示すテーブル識別子 (TID) を指定する。

pFilter

[in]  MPEG2_FILTER 構造体へのオプションのポインタ。呼び出し元はこのパラメータを使って、追加の MPEG-2 ヘッダー フィールドに基づいてパケットを除外できる。このパラメータは NULL でもよい。

timeout

[in]  同期要求がタイムアウトになるまでの最大待機時間を指定する。

hDoneEvent

[in]  イベントへのハンドルを指定する。このオブジェクトは要求が完了するとイベントを通知する。このパラメータはオプションである。非同期要求については指定する必要がある。

戻り値

このメソッドは HRESULT を返す。次のいずれかの値を返す。

戻りコード 説明
E_INVALIDARG 無効な引数。
E_OUTOFMEMORY メモリ不足。
MPEG2_E_ALREADY_INITIALIZED オブジェクトは既に初期化されている。
S_OK メソッドが成功した。

注意

このメソッドは、requestType パラメータで定義されている要求のタイプに応じて、同期の場合と非同期の場合がある。このメソッドが非同期の場合、メソッドはすぐに戻り、hDoneEvent で指定されたイベントを通知する。このメソッドが同期の場合、メソッドは要求が完了するか、または timeout パラメータで指定されたタイムアウトの時間が経過するまでブロックする。

参照