IPort::GetDeviceProperty メソッド (portcls.h)

GetDeviceProperty メソッドを使用すると、プラグ アンド プレイ デバイスのレジストリに含まれているデバイス プロパティに簡単にアクセスできます。

構文

NTSTATUS GetDeviceProperty(
  DEVICE_REGISTRY_PROPERTY DeviceProperty,
  ULONG                    BufferLength,
  PVOID                    PropertyBuffer,
  PULONG                   ResultLength
);

パラメーター

DeviceProperty

呼び出し元が要求している特定のデバイス プロパティを識別します。 このパラメーターの有効な値は、IoGetDeviceProperty 呼び出しの DeviceProperty パラメーターに対して定義されているものと同じです。

BufferLength

要求された情報を受信するバッファーの長さをバイト単位で指定します。

PropertyBuffer

プロパティ バッファーへのポインター。 このパラメーターは、メソッドが要求されたプロパティ情報を書き込む呼び出し元によって割り当てられたバッファーを指します。 バッファーは、BufferLength で指定されたバイト数を格納するのに十分な大きさである必要があります。

ResultLength

返されるデータの長さを示す出力ポインター。 このパラメーターは、メソッドが PropertyBuffer バッファーに実際に書き込まれたバイト数を指定するカウントを書き込む呼び出し元によって割り当てられた ULONG 変数を指します。 ただし、バッファーが小さすぎて情報を含めなければ、メソッドは必要なバッファー サイズを出力します。

戻り値

このメソッドは、呼び出しが成功した場合にSTATUS_SUCCESSを含む NTSTATUS を返します。 それ以外の場合、メソッドは適切なエラー コードを返します。 呼び出し元によって提供されるプロパティ バッファーが小さすぎる場合、メソッドはSTATUS_BUFFER_TOO_SMALLを返し、必要なサイズを ReturnLength に出力します。

備考

このメソッドは、オーディオ アダプターのデバイスプロパティを取得します。 PcGetDeviceProperty 関数と同様の操作ですが、ターゲット デバイスを明示的に指定するデバイス オブジェクトを必要とするのではなく、オーディオ アダプターのデバイス プロパティを自動的に取得する点が異なります。

必要条件

要件	価値
ヘッダー	portcls.h
IRQL	PASSIVE_LEVEL

関連項目

IPort を する