IMDSPDevice3::D eviceIoControl メソッド (mswmdm.h)

[アーティクル]
03/05/2024

DeviceIoControl メソッドは、デバイス I/O コントロールを呼び出します。

構文

HRESULT DeviceIoControl(
  [in]  DWORD   dwIoControlCode,
  [in]  BYTE    *lpInBuffer,
  [in]  DWORD   nInBufferSize,
  [out] BYTE    *lpOutBuffer,
  [in]  LPDWORD pnOutBufferSize
);

パラメーター

[in] dwIoControlCode

デバイスに送信される I/O 制御コード。

[in] lpInBuffer

呼び出し元アプリケーションによって提供される入力バッファー。 nInBufferSize が 0 の場合、NULL を指定できます。

[in] nInBufferSize

lpInBuffer のサイズ (バイト単位)。

[out] lpOutBuffer

出力バッファー。呼び出し元のアプリケーションによって提供されます。

[in] pnOutBufferSize

lpOutBuffer のサイズ (バイト単位)。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

このメソッドは、アプリケーションとサービスプロバイダー間の通信のプライベートモードを提供します。サービスプロバイダーは、この IOCTL を処理し、必要に応じて変更し、カーネルモードドライバーに渡すことができます。

IMDSPDevice::SendOpaqueCommand と比較して、このメソッドは、出力バッファーが呼び出し元によって提供されるため、DeviceIoControl Windows API とより適切に連携します。また、IMDSPDevice::SendOpaqueCommand とは異なり、このメソッドには MAC チェックは含まれず、より効率的です。