Microsoft DirectX 8.0 (C++) |
IKsControl インターフェイスは、プロパティ、イベント、およびメソッドのサポートを取得、設定、または問い合わせるために使われる。このインターフェイスは、Windows ドライバ モデル カーネル ストリーミング アーキテクチャの一部であるが、DirectMusic によっても使用され、DirectMusic ポートのプロパティを公開する。このインターフェイスを取得するには、riid パラメータに IID_IKsControl を指定して IDirectMusicPort8::QueryInterface メソッドを呼び出す。
プロパティ項目の要求をポートに対して送信する作業は、ポートの実装に依存する。Win32 ハンドルベースのマルチメディア呼び出し (midiOut と midiIn の各関数) を利用して DirectMusic のエミュレーションを行っているポートは、どのプロパティをもサポートしない。
プラグ可能なソフトウェア シンセサイザを表すポートに対してプロパティ項目を要求すると、完全にユーザー モードで応答がなされる。このタイプのポートのトポロジは、シンク ノード (IDirectMusicSynthSinkインターフェイス) に接続されたシンセサイザ (IDirectMusicSynthインターフェイスによって表される) である。このプロパティ要求は最初にシンセサイザ ノードに割り当てられ、シンセサイザがこの要求を認識しない場合はシンク ノードに割り当てられる。
このインターフェイスは、以下のメソッドをサポートする。現在のところ、KsProperty だけが DirectMusic によってサポートされている。
IKsControl | KsProperty |
KsEvent | |
KsMethod |
すべての COM インターフェイスは IUnknown インターフェイスのメソッドを継承する。IUnknown インターフェイスは、以下の 3 つのメソッドをサポートする。
IUnknown | AddRef |
QueryInterface | |
Release |
ヘッダー : dmksctrl.h で宣言。