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

[アーティクル]
02/26/2024

ルーチンは 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 メンバーにバッファーの サイズ をバイト単位で書き込みます。