Win32 API 日本語リファレンス
ホーム › Devices.Tapi › ITAllocatorProperties

ITAllocatorProperties

COM
📘 Microsoft Learn (日本語) · English
IIDc1bc3c90-bcfe-11d1-9745-00c04fd91ac0継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ITAllocatorProperties インターフェイス (tapi3ds.h) は、Media Streaming Terminal (MST) のバッファアロケータープロパティを、エンドユーザーアプリケーションまたはサーバーアプリケーションに公開します。

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT SetAllocatorProperties(ALLOCATOR_PROPERTIES* pAllocProperties)

ITAllocatorProperties::SetAllocatorProperties メソッド (tapi3ds.h) は、フィルターのネゴシエーション時に、入力した値を MSP に強制的に使用させます。

pAllocPropertiesALLOCATOR_PROPERTIES*inアロケーターバッファへのポインター。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合はエラー値を返します。

解説(Remarks)

このメソッドは細心の注意を払って使用してください。 このメソッドに入力した値が MSP にとって最適でない場合、音質が低下することがあります。そのため、アプリケーションはこのメソッドを呼び出す前に、MSP が推奨するプロパティを正確に把握しておく必要があります。Windows 2000 では、このメソッドの呼び出し時に入力されたプロパティは、最適でない場合には無視されます。Windows XP では、これらの値は無視されないため、アプリケーションはより深い知識を持っている必要があります。

アプリケーションが一貫したバッファサイズの設定のみを目的とする場合は、代わりに ITAllocatorProperties::SetBufferSize メソッドを使用してください。これにより、指定したバッファサイズがアプリケーションに提供されることが保証されます。

vtbl 4 HRESULT GetAllocatorProperties(ALLOCATOR_PROPERTIES* pAllocProperties)

GetAllocatorProperties メソッド (tapi3ds.h) は、接続後にアロケータープロパティの現在の値を取得し、ネゴシエーションされた値を提供します。

pAllocPropertiesALLOCATOR_PROPERTIES*out現在のアロケーター値へのポインター。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合はエラー値を返します。

vtbl 5 HRESULT SetAllocateBuffers(BOOL bAllocBuffers)

ITAllocatorProperties::SetAllocateBuffers メソッド (tapi3ds.h) は、現在のアロケーターバッファを設定する必要があるかどうかを決定します。

bAllocBuffersBOOLinアロケーターバッファを設定する必要があるかどうかを示すブール値。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合はエラー値を返します。

vtbl 6 HRESULT GetAllocateBuffers(BOOL* pbAllocBuffers)

ITAllocatorProperties::GetAllocateBuffers メソッド (tapi3ds.h) は、現在のアロケーターバッファを取得できるかどうかを決定します。

pbAllocBuffersBOOL*outアロケーターバッファが設定されているかどうかを示します。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合はエラー値を返します。

vtbl 7 HRESULT SetBufferSize(DWORD BufferSize)

ITAllocatorProperties::SetBufferSize メソッド (tapi3ds.h) は、アロケーターバッファのサイズを設定します。

BufferSizeDWORDinアロケーターバッファのサイズ。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合はエラー値を返します。

vtbl 8 HRESULT GetBufferSize(DWORD* pBufferSize)

ITAllocatorProperties::GetBufferSize メソッド (tapi3ds.h) は、アロケーターバッファのサイズを取得します。

pBufferSizeDWORD*out現在のアロケーターバッファのサイズ。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合はエラー値を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_ITAllocatorProperties "{C1BC3C90-BCFE-11D1-9745-00C04FD91AC0}"
#usecom global ITAllocatorProperties IID_ITAllocatorProperties "{}"
#comfunc global ITAllocatorProperties_SetAllocatorProperties  3 var
#comfunc global ITAllocatorProperties_GetAllocatorProperties  4 var
#comfunc global ITAllocatorProperties_SetAllocateBuffers      5 int
#comfunc global ITAllocatorProperties_GetAllocateBuffers      6 var
#comfunc global ITAllocatorProperties_SetBufferSize           7 int
#comfunc global ITAllocatorProperties_GetBufferSize           8 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。