WdfDeviceQueryInterfaceProperty 関数 (wdfdevice.h)

[UMDF にのみ適用]

WdfDeviceQueryInterfaceProperty メソッドは、指定されたデバイス インターフェイス プロパティを取得します。

構文

NTSTATUS WdfDeviceQueryInterfaceProperty(
  [in]  WDFDEVICE                           Device,
  [in]  PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]  ULONG                               BufferLength,
  [out] PVOID                               PropertyBuffer,
  [out] PULONG                              ResultLength,
  [out] PDEVPROPTYPE                        Type
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] PropertyData

取得するデバイス インターフェイス プロパティを識別する WDF_DEVICE_INTERFACE_PROPERTY_DATA 構造体へのポインター。

[in] BufferLength

PropertyBuffer によって指されるバッファーのサイズ (バイト単位 。

[out] PropertyBuffer

要求されたデバイス インターフェイス プロパティを受け取る呼び出し元によって割り当てられたバッファーへのポインター。 BufferLength パラメーターが 0 の場合、ポインターは NULL にすることができます。

[out] ResultLength

呼び出し元が指定した場所。戻り値には、PropertyBufferに格納 WdfDeviceQueryInterfaceProperty 情報のサイズ (バイト単位) が含まれます。 関数の戻り値が STATUS_BUFFER_TOO_SMALL場合、この場所は必要なバッファー サイズを受け取ります。

[out] Type

DEVPROPTYPEが指すバッファーに格納されている WdfDeviceQueryInterfaceProperty プロパティ データの型を識別する型指定された変数 ポインター。

戻り値

WdfDeviceQueryInterfaceProperty メソッドでエラーが発生しなかった場合は、STATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

このメソッドは、他NTSTATUS 値を返す場合があります。

備考

デバイス プロパティ データを受信する前に、ドライバーは通常、必要なバッファー サイズを取得するためだけに、WdfDeviceQueryInterfaceProperty メソッドを呼び出します。 一部のプロパティでは、必要なサイズが返されたときと、ドライバーが WdfDeviceQueryInterfaceProperty を再度呼び出すとき データ サイズが変更される可能性があります。 そのため、ドライバーは、戻り値の状態がSTATUS_BUFFER_TOO_SMALLされないまで実行されるループ内 WdfDeviceQueryInterfaceProperty を呼び出す必要があります。

WdfDeviceQueryInterfaceProperty は、必要なバッファー サイズが既知で変更されていない場合にのみ使用することをお勧めします。その場合、ドライバーは WdfDeviceQueryInterfaceProperty 1 回だけ呼び出 す必要があるためです。 必要なバッファー サイズが不明な場合、または異なる場合、ドライバーは WdfDeviceAllocAndQueryInterfaceProperty 呼び出す必要があります。

関連するメソッドの詳細については、「統合デバイス プロパティ モデルへのアクセス」を参照してください。

必要条件

関連項目

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAllocAndQueryInterfaceProperty の

WdfDeviceAssignInterfaceProperty の