Win32 API 日本語リファレンス
ホーム › System.UpdateAgent › IWindowsDriverUpdate

IWindowsDriverUpdate

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDb383cd1a-5ce9-4504-9f63-764b1236f191継承元IUpdate呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl52

公式ドキュメント

Windows ドライバー更新プログラムからのみ利用できるプロパティとメソッドを提供します。

解説(Remarks)

このインターフェイスは、QueryInterface メソッドを IUpdate インターフェイスに対して呼び出すことで取得できますが、そのインターフェイスが Windows ドライバー更新プログラムを表している場合に限られます。

メソッド 8

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 52 HRESULT get_DriverClass(LPWSTR* retval)

Windows ドライバー更新プログラムのクラスを取得します。

retvalLPWSTR*outドライバーのデバイスクラスを受け取る文字列ポインタへのポインタである。
vtbl 53 HRESULT get_DriverHardwareID(LPWSTR* retval)

Windows ドライバー更新プログラムがインストール可能となるために一致する必要があるハードウェア ID または互換 ID を取得します。

retvalLPWSTR*outドライバーが対応するハードウェア ID を受け取る文字列ポインタへのポインタである。
vtbl 54 HRESULT get_DriverManufacturer(LPWSTR* retval)

Windows ドライバー更新プログラムの製造元の言語に依存しない名前を取得します。(IWindowsDriverUpdate.get_DriverManufacturer)

retvalLPWSTR*outドライバーの製造元名を受け取る文字列ポインタへのポインタである。
vtbl 55 HRESULT get_DriverModel(LPWSTR* retval)

Windows ドライバー更新プログラムの対象デバイスの言語に依存しないモデル名を取得します。(IWindowsDriverUpdate.get_DriverModel)

retvalLPWSTR*outドライバーが対応するデバイスのモデル名を受け取る文字列ポインタへのポインタである。
vtbl 56 HRESULT get_DriverProvider(LPWSTR* retval)

Windows ドライバー更新プログラムのプロバイダーの言語に依存しない名前を取得します。(IWindowsDriverUpdate.get_DriverProvider)

retvalLPWSTR*outドライバーの提供元名を受け取る文字列ポインタへのポインタである。
vtbl 57 HRESULT get_DriverVerDate(DOUBLE* retval)

Windows ドライバー更新プログラムのドライバーバージョン日付を取得します。(IWindowsDriverUpdate.get_DriverVerDate)

retvalDOUBLE*outドライバーのバージョン日付 (DATE 値) を受け取る出力先へのポインタである。
vtbl 58 HRESULT get_DeviceProblemNumber(INT* retval)

Windows ドライバー更新プログラムに一致するデバイスの問題番号を取得します。(IWindowsDriverUpdate.get_DeviceProblemNumber)

retvalINT*out対象デバイスの問題番号を受け取る出力先へのポインタである。
vtbl 59 HRESULT get_DeviceStatus(INT* retval)

Windows ドライバー更新プログラムに一致するデバイスの状態を取得します。(IWindowsDriverUpdate.get_DeviceStatus)

retvalINT*out対象デバイスの状態を表す値を受け取る出力先へのポインタである。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IWindowsDriverUpdate "{B383CD1A-5CE9-4504-9F63-764B1236F191}"
#usecom global IWindowsDriverUpdate IID_IWindowsDriverUpdate "{}"
#comfunc global IWindowsDriverUpdate_get_DriverClass          52 var
#comfunc global IWindowsDriverUpdate_get_DriverHardwareID     53 var
#comfunc global IWindowsDriverUpdate_get_DriverManufacturer   54 var
#comfunc global IWindowsDriverUpdate_get_DriverModel          55 var
#comfunc global IWindowsDriverUpdate_get_DriverProvider       56 var
#comfunc global IWindowsDriverUpdate_get_DriverVerDate        57 var
#comfunc global IWindowsDriverUpdate_get_DeviceProblemNumber  58 var
#comfunc global IWindowsDriverUpdate_get_DeviceStatus         59 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。