IKsControl::KsProperty
プロパティの値を取得または設定する。概要については、「DirectMusic ポートのプロパティ セット」を参照すること。
HRESULT KsProperty(
PKSPROPERTY pProperty,
ULONG ulPropertyLength,
LPVOID pvPropertyData,
ULONG ulDataLength,
PULONG pulBytesReturned
);
パラメータ
- pProperty
- プロパティ セット、項目、実行する操作を指定する KSPROPERTY 構造体のアドレス。このプロパティにインスタンス データが含まれる場合、そのデータはメモリ内で構造体のすぐ後に置かれていなければならない。
- ulPropertyLength
- pProperty が指すメモリの長さ。任意のインスタンス データも含む。
- pvPropertyData
- 設定操作の場合、プロパティの新しい値を表すデータを含むメモリ バッファのアドレス。取得操作の場合、プロパティの値を十分に保持できるメモリのアドレス。基本的なサポートの問い合わせの場合、サイズが最低でも DWORD のバッファのアドレス。
- ulDataLength
- pvPropertyData が指すバッファの長さ。
- pulBytesReturned
- KSPROPERTY_TYPE_GET または KSPROPERTY_TYPE_BASICSUPPORT の呼び出しで、ポートによって pvPropertyData に返されるバイト数を受け取る変数のアドレス。
戻り値
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
ヘッダー : dmksctrl.h で宣言。
参照
DirectMusic ポートのプロパティ セット