WDF_DEVICE_PNP_CAPABILITIES Struktur (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WDF_DEVICE_PNP_CAPABILITIES Struktur beschreibt die Plug- und Play-Funktionen eines Geräts.
Syntax
typedef struct _WDF_DEVICE_PNP_CAPABILITIES {
ULONG Size;
WDF_TRI_STATE LockSupported;
WDF_TRI_STATE EjectSupported;
WDF_TRI_STATE Removable;
WDF_TRI_STATE DockDevice;
WDF_TRI_STATE UniqueID;
WDF_TRI_STATE SilentInstall;
WDF_TRI_STATE SurpriseRemovalOK;
WDF_TRI_STATE HardwareDisabled;
WDF_TRI_STATE NoDisplayInUI;
ULONG Address;
ULONG UINumber;
} WDF_DEVICE_PNP_CAPABILITIES, *PWDF_DEVICE_PNP_CAPABILITIES;
Elemente
Size
Die Größe dieser Struktur in Byte.
LockSupported
Ein WDF_TRI_STATE-typd-Wert, der angibt, ob es auf WdfTrue-festgelegt ist, dass das Gerät in seinem Steckplatz gesperrt werden kann, um die Ejection zu verhindern. (Mit dieser Funktion wird das Auswerfen eines Geräts vom Steckplatz deaktiviert, nicht das Auswerfen von Medien von einem Gerät.) Weitere Informationen zu WDF_TRI_STATE eingegebenen Werten finden Sie im folgenden Abschnitt "Hinweise".
EjectSupported
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob es auf WdfTrue-festgelegt ist, dass das Gerät vom Steckplatz ausgeworfen werden kann. (Diese Funktion ermöglicht das Auswerfen eines Geräts aus dem Steckplatz und nicht das Auswerfen von Medien von einem Gerät.)
Removable
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob es auf WdfTrue-festgelegt ist, dass das Gerät entfernt werden kann, während das System ausgeführt wird. Wenn Wechselmedien auf WdfTrue- und SurpriseRemovalOK- auf WdfFalse-festgelegt ist, sollten Die Benutzer das Programm "Unplug" oder "Eject Hardware" des Systems verwenden.
DockDevice
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob WdfTrue-festgelegt ist, dass es sich bei dem Gerät um eine Dockingstation handelt.
UniqueID
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob für WdfTruefestgelegt ist, dass die Instanz-ID des Geräts für das gesamte System eindeutig ist. Wenn UniqueID- auf WdfFalse-festgelegt ist, ist die Instanz-ID nur für den Bus des Geräts eindeutig. Weitere Informationen zu Instanz-IDs finden Sie unter Device Identification Strings.
SilentInstall
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob er auf WdfTrue-festgelegt ist, sollte der Geräte-Manager dialogfelder während der Installation des Geräts nicht anzeigen.
SurpriseRemovalOK
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob er auf WdfTrue- festgelegt ist (und wenn Wechselmedien auch auf WdfTruefestgelegt ist), können Benutzer das Gerät entfernen, ohne das Unplug- oder Eject Hardware-Programm des Systems zu verwenden.
HardwareDisabled
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob auf WdfTrue-festgelegt ist, dass das Gerät deaktiviert ist.
NoDisplayInUI
Ein WDF_TRI_STATE typisierter Wert, der angibt, ob er auf WdfTrue-festgelegt ist, sollte der Geräte-Manager das Gerät nicht anzeigen.
Address
Eine Adresse, die angibt, wo sich das Gerät in seinem Bus befindet.
Die Auslegung dieser Nummer ist busspezifisch. Wenn die Adresse unbekannt ist oder der Bustreiber keine Adresse unterstützt, verlässt der Bustreiber den Address Member am Standardwert von 0xFFFFFFFF (-1).
In der folgenden Liste werden die Informationen beschrieben, die bestimmte Bustreiber im Address Member für ihre untergeordneten Geräte speichern:
| Bus | BESCHREIBUNG |
|---|---|
| 1394 | Gibt keine Adresse an, da die Adressen veränderlich sind. Der Standardwert ist 0xFFFFFFFF. |
| EISA | Steckplatznummer (0-F). |
| IDE | Bei einem IDE-Gerät enthält die Adresse die Ziel-ID und LUN. Bei einem IDE-Kanal ist die Adresse null oder eins (0 = primärer Kanal und 1 = sekundärer Kanal). |
| ISApnp | Gibt keine Adresse an. Der Standardwert ist 0xFFFFFFFF. |
| PC-Karte (PCMCIA) | Die Socketnummer (in der Regel 0x00 oder 0x40). |
| PCI | Die Gerätenummer im hohen Wort und die Funktionsnummer im wortarmen Wort. |
| SCSI | Die Ziel-ID. |
| USB | Die Portnummer. |
UINumber
Eine Zahl, die dem Gerät zugeordnet ist und in Benutzeroberflächen angezeigt werden kann. Diese Nummer ist in der Regel eine vom Benutzer wahrgenommene Steckplatznummer, z. B. eine Nummer, die neben dem Steckplatz auf der Tafel gedruckt wird, oder eine andere Nummer, die dem Benutzer hilft, das Gerät zu finden. Wenn UINumber- unbekannt ist oder die Angabe einer Zahl dem Benutzer beim Identifizieren der Position des Geräts nicht hilft, legt der Treiber diesen Wert auf -1 fest.
Bemerkungen
Mehrere Member verwenden den WDF_TRI_STATE Typ. Für diese Member gibt ein Wert von WdfTrue- an, dass das Gerät die Funktion unterstützt, und ein Wert von WdfFalse angibt, dass dies nicht der Fall ist. Ein Wert von WdfUseDefault gibt an, dass das Framework den Wert verwendet, den ein Treiber niedriger im bereitgestellten Stapel verwendet. Wenn beispielsweise ein Bustreiber WdfTrue- für LockSupported- angibt und der Funktionstreiber des Geräts WdfUseDefault-angibt, speichert das Framework WdfTrue- für die Funktion.
Die WDF_DEVICE_PNP_CAPABILITIES-Struktur wird als Eingabe für WdfDeviceSetPnpCapabilitiesverwendet.
Um eine WDF_DEVICE_PNP_CAPABILITIES-Struktur zu initialisieren, sollte ein Treiber WDF_DEVICE_PNP_CAPABILITIES_INITaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen Wdf.h) |