次の方法で共有


PGET_DEVICE_INFORMATION コールバック関数 (hdaudio.h)

ルーチンは GetDeviceInformation 、HD オーディオ コントローラー デバイスに関する情報を取得します。

ルーチンの関数ポインター型 GetDeviceInformation は、次のように定義されます。

構文

PGET_DEVICE_INFORMATION PgetDeviceInformation;

NTSTATUS PgetDeviceInformation(
  [in]      PVOID _context,
  [in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}

パラメーター

[in] _context

HDAUDIO_BUS_INTERFACEまたはHDAUDIO_BUS_INTERFACE_V2構造体の Context メンバーのコンテキスト値を指定します。

[in, out] DeviceInformation

HD オーディオ コントローラー デバイスに関する情報を取得します。 このパラメーターは、ルーチンがデバイス情報を書き込む呼び出し元によって割り当てられた HDAUDIO_DEVICE_INFORMATION 構造体を指します。

戻り値

GetDeviceInformation は、呼び出しが成功した場合は STATUS_SUCCESS を返します。 それ以外の場合、ルーチンは適切なエラー コードを返します。 次の表は、可能な戻り状態コードを示しています。

リターン コード 説明
STATUS_BUFFER_TOO_SMALL
deviceInformation バッファーの先頭で指定されたサイズが小さすぎることを示します。

注釈

このルーチンは、静的なデバイス依存の情報を取得します。つまり、情報は時間の経過と同時に動的に変更されることはありません。

deviceInformation パラメーターは、ルーチンが HD オーディオ コントローラーに関する情報を書き込むHDAUDIO_DEVICE_INFORMATION構造体を含むバッファーへのポインターです。 を呼び出す前に、呼び出 GetDeviceInformationし元はバッファーを割り当て、バッファーの先頭にある Size メンバーにバッファーの サイズ をバイト単位で書き込みます。

要件

要件
対象プラットフォーム デスクトップ
Header hdaudio.h (Hdaudio.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION