IWDFDevice インターフェイス (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。
IWDFDevice インターフェイスは、システム上のデバイスの表現であるデバイス オブジェクトを公開します。
継承
IWDFDevice インターフェイスは IWDFObject から継承されます。 IWDFDevice には、次の種類のメンバーもあります。
- メソッド
メソッド
IWDFDevice インターフェイスには、これらのメソッドがあります。
| IWDFDevice::AssignDeviceInterfaceState AssignDeviceInterfaceState メソッドは、デバイスの指定されたデバイス インターフェイス インスタンスを有効または無効にします。 |
| IWDFDevice::CommitPnpState CommitPnpState メソッドは、IWDFDevice::SetPnpState メソッドが設定したプラグ アンド プレイ (PnP) プロパティの状態 (つまり、オン、オフ、または既定の状態に設定) をコミットします。 |
| IWDFDevice::ConfigureRequestDispatching ConfigureRequestDispatching メソッドは、指定した種類の I/O 要求のキューを、指定された I/O キューに構成します。 |
| IWDFDevice::CreateDeviceInterface CreateDeviceInterface メソッドは、デバイス インターフェイス クラスのインスタンスを作成します。 |
| IWDFDevice::CreateIoQueue CreateIoQueue メソッドは、デバイスに関連付けられている既定の I/O キューを構成するか、デバイスのセカンダリ I/O キューを作成します。 |
| IWDFDevice::CreateRequest CreateRequest メソッドは、書式設定されていない要求オブジェクトを作成します。 |
| IWDFDevice::CreateSymbolicLink CreateSymbolicLink メソッドは、デバイスのシンボリック リンクを作成します。 |
| IWDFDevice::CreateWdfFile CreateWdfFile メソッドは、ドライバーが使用するファイル オブジェクトを作成します。 |
| IWDFDevice::GetDefaultIoQueue GetDefaultIoQueue メソッドは、デバイスの既定の I/O キューのインターフェイスを取得します。 |
| IWDFDevice::GetDefaultIoTarget GetDefaultIoTarget メソッドは、デバイス インスタンスの既定の I/O ターゲットのインターフェイスを取得します。 |
| IWDFDevice::GetDriver GetDriver メソッドは、デバイス インスタンスの親ドライバー オブジェクトへのインターフェイスを取得します。 |
| IWDFDevice::GetPnpState GetPnpState メソッドは、デバイスの指定されたプラグ アンド プレイ (PnP) プロパティがオンまたはオフ (または既定の状態に設定) かどうかを判断します。 |
| IWDFDevice::P ostEvent PostEvent メソッドは、ドライバーから指定されたイベントを待機しているアプリケーションに非同期的に通知します。 |
| IWDFDevice::RetrieveDeviceInstanceId RetrieveDeviceInstanceId メソッドは、デバイスのインスタンスの識別子を取得します。 |
| IWDFDevice::RetrieveDeviceName RetrieveDeviceName メソッドは、基になるカーネル モード デバイスの名前を取得します。 |
| IWDFDevice::RetrieveDevicePropertyStore RetrieveDevicePropertyStore メソッドは、プロパティ ストア インターフェイスを取得します。 ドライバーは、 メソッドを使用してレジストリにアクセスできます。 |
| IWDFDevice::SetPnpState SetPnpState メソッドは、デバイスの指定したプラグ アンド プレイ (PnP) プロパティをオンまたはオフ (または既定の状態に設定) します。 |
注釈
各デバイス オブジェクトには、親ドライバー オブジェクトがあります。 新しいデバイスがシステムに到着すると、フレームワークは親ドライバーの IDriverEntry::OnDeviceAdd コールバック関数を呼び出して、ドライバーに到着について通知します。 その後、ドライバーは IWDFDriver::CreateDevice メソッドを呼び出して、新しいデバイス オブジェクトの IWDFDevice インターフェイスへのポインターを受け取ることができます。
要件
| 要件 | 値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| 対象プラットフォーム | デスクトップ |
| 最小 UMDF バージョン | 1.5 |
| Header | wudfddi.h (Wudfddi.h を含む) |