Platform SDK: DirectX

IDirectMusicPort::DeviceIoControl

IDirectMusicPort::DeviceIoControl メソッドは、ポートを実装する根底のファイルに対して Win32 の DeviceIoControl 関数を呼び出す。

HRESULT DeviceIoControl(
  DWORD dwIoControlCode, 
  LPVOID lpInBuffer, 
  DWORD nInBufferSize, 
  LPVOID lpOutBuffer, 
  DWORD nOutBufferSize, 
  LPDWORD lpBytesReturned, 
  LPOVERLAPPED lpOverlapped
);

パラメータ

dwIoControlCode
実行される制御コード。
lpInBuffer
入力データを含むバッファへのポインタ。
nInBufferSize
入力バッファのサイズ。
lpOutBuffer
出力データを受け取るバッファへのポインタ。
nOutBufferSize
出力バッファのサイズ。
lpBytesReturned
出力バイト数を受け取る変数のアドレス。
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 で宣言。