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

  • [アーティクル]

GetDeviceProperty メソッドを使用すると、プラグ アンド プレイ デバイスのレジストリに含まれるデバイス プロパティへの簡単なアクセスが提供されます。

構文

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

パラメーター

DeviceProperty

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

BufferLength

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

PropertyBuffer

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

ResultLength

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

戻り値

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

注釈

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

要件

要件 値
Header portcls.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

IPort