Platform SDK: DirectX |
IDirectMusicPort::DeviceIoControl メソッドは、ポートを実装する根底のファイルに対して Win32 の DeviceIoControl 関数を呼び出す。
HRESULT DeviceIoControl( DWORD dwIoControlCode, LPVOID lpInBuffer, DWORD nInBufferSize, LPVOID lpOutBuffer, DWORD nOutBufferSize, LPDWORD lpBytesReturned, LPOVERLAPPED lpOverlapped );
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
E_POINTER |
E_NOTIMPL |
Windows ドライバモデル (WDM) フィルタグラフを実装しているポートでのみ、このメソッドはサポートされている。WDM フィルタ グラフを使っている場合、ファイル ハンドルはグラフ内の最上位のピンとして利用される。
DirectMusic がフィルタ グラフに対して実行している操作と、ピンに対して定義されたカーネル ストリーミングが衝突する可能性がある場合、DirectMusic はカーネル ストリーミングの実行を拒否できる。ただし、ユーザー定義の操作は決して妨害されない。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusicc.h で宣言。