SetupDiGetDeviceInterfaceDetailA 関数 (setupapi.h)
SetupDiGetDeviceInterfaceDetail 関数は、デバイス インターフェイスに関する詳細を返します。
構文
WINSETUPAPI BOOL SetupDiGetDeviceInterfaceDetailA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
[out, optional] PSP_DEVICE_INTERFACE_DETAIL_DATA_A DeviceInterfaceDetailData,
[in] DWORD DeviceInterfaceDetailDataSize,
[out, optional] PDWORD RequiredSize,
[out, optional] PSP_DEVINFO_DATA DeviceInfoData
);
パラメーター
[in] DeviceInfoSet
詳細を取得するインターフェイスを含む
[in] DeviceInterfaceData
詳細を取得する DeviceInfoSet 内のインターフェイス
[out, optional] DeviceInterfaceDetailData
指定したインターフェイスに関する情報を受け取る SP_DEVICE_INTERFACE_DETAIL_DATA 構造体へのポインター。 このパラメーターは省略可能であり、NULL
[in] DeviceInterfaceDetailDataSize
DeviceInterfaceDetailData バッファーのサイズ。 構造体の固定部分と空
DeviceInterfaceDetailData
[out, optional] RequiredSize
DeviceInterfaceDetailData バッファーの必要なサイズを受け取る DWORD 型の変数へのポインター。 このサイズには、構造体の固定部分のサイズと、可変長デバイス パス文字列に必要なバイト数が含まれます。 このパラメーターは省略可能であり、NULL
[out, optional] DeviceInfoData
要求されたインターフェイスをサポートするデバイスに関する情報を受け取るバッファーへのポインター。 呼び出し元は、DeviceInfoData
戻り値
SetupDiGetDeviceInterfaceDetail
備考
この関数を使用してインターフェイスの詳細を取得するには、通常、次の 2 つの手順を実行します。
-
必要なバッファー サイズを取得します。
NULL DeviceInterfaceDetailData ポインター、DeviceInterfaceDetailDataSize 0、および有効なRequiredSize 変数を使用して、SetupDiGetDeviceInterfaceDetailを呼び出します。 このような呼び出しに応答して、この関数は RequiredSize で必要なバッファー サイズ返し、 GetLastError がERROR_INSUFFICIENT_BUFFERを返して失敗します。 - 適切なサイズのバッファーを割り当て、関数をもう一度呼び出してインターフェイスの詳細を取得します。
SetupDiGetDeviceInterfaceDetail を使用して、DeviceInfoDataのみを取得できます。 インターフェイスが存在するが、DeviceInterfaceDetailData が NULL
手記
setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupDiGetDeviceInterfaceDetail を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
ターゲット プラットフォーム の |
デスクトップ |
ヘッダー | setupapi.h (Setupapi.h を含む) |
ライブラリ | Setupapi.lib |
関連項目
SetupDiEnumDeviceInterfaces の
SetupDiGetClassDevs の