Clienteigenschaften

Windows Portable Geräte unterstützen die folgenden Clienteigenschaften.

Eigenschaft VarType BESCHREIBUNG
GEWÜNSCHTER _ _ WPD-CLIENTZUGRIFF _ VT _ UI4 Ein -Wert, der angibt, dass der Client eindeutige Zugriffsberechtigungen erfordert, z. B. GENERIC _ READ Only. Wenn diese Eigenschaft nicht festgelegt ist, geht WPD von GENERIC READ GENERIC WRITE aus. Dies _ | ist die empfohlene _ Standardeinstellung.
_ _ WPD-CLIENT-HAUPTVERSION _ VT _ UI4 Eine Zahl, die die Hauptversion des Clients angibt.
_ _ WPD-CLIENT-NEBENVERSION _ VT _ UI4 Eine Zahl, die die Nebenversion des Clients angibt.
_WPD-CLIENTNAME _ VT _ LPWSTR Eine Namenszeichenfolge für die Clientanwendung.
_ _ WPD-CLIENTREVISION VT _ UI4 Eine Zahl, die die Revision (oder Buildnummer) des Clients angibt.
WPD _ CLIENT _ SECURITY _ QUALITY _ OF _ SERVICE VT _ UI4 Ein -Wert, der die Sicherheitsqualität des Diensts für die Verbindung mit dem Treiber angibt. Dies bezieht sich auf die Quality of Service für CreateFile.
Diese Flags ermöglichen oder erlauben beispielsweise einem Treiber, die Identität des Clients zu imitieren. SECURITY _ IDENTIFICATION wird angenommen, wenn dieser Wert nicht angegeben wird. In der Regel sollten Anwendungen diesen Wert auf SECURITY IMPERSONATION festlegen, da einige Treiber identitätswechseln _ müssen, um zu funktionieren. Anwendungen, die unter strengen Sicherheitsanforderungen mit einer bekannten Teilmenge von Geräten ausgeführt werden, möchten jedoch möglicherweise die Fähigkeit des Treibers einschränken, den Aufrufer zu identifizieren oder seine Identität zu verwenden. Beachten Sie, dass das Reduzieren der Identitätswechselebene auf einen niedrigeren Wert als SECURITY IMPERSONATION dazu führen kann, dass einige Treiber _ die Funktionalität verringern.
_ _ WPD-CLIENTFREIGABEMODUS _ VT _ UI4 Ein -Wert, der den Freigabemodus angibt, den der Client vom Treiber angibt. Die möglichen Werte sind identisch mit für CreateFile, z. B. FILE _ SHARE _ READ, FILE _ SHARE WRITE und _ so weiter.
FILE _ SHARE READ FILE SHARE WRITE wird _ | _ _ angenommen, wenn der Client diesen Parameter nicht angibt. Dies ist die empfohlene Standardeinstellung. Wenn jedoch ein anderer Freigabemodus erforderlich ist, z. B. FILE SHARE READ, um nur die schreibgeschützte Freigabe an _ _ fordern, ist dieser Parameter erforderlich.
WPD _ CLIENT _ WMDRM _ APPLICATION _ PRIVATE _ KEY VT _ VECTOR _ | VT _ UI1 Ein -Wert, der Windows privaten Schlüssel der Media DRM-Anwendung des Clients angibt.
_ _ WPD-CLIENT-WMDRM-ANWENDUNGSZERTIFIKAT _ _ VT _ VECTOR _ | VT _ UI1 Ein -Wert, der das Windows Media DRM-Zertifikat des Clients angibt.
_ _ _ WPD-CLIENTEREIGNISCOOKIE VT _ LPWSTR Ein vom Client bereitgestelltes Cookie, das vom Treiber in Ereignissen zurückgegeben wird, die als direktes Ergebnis der von diesem Client ausgegebenen Vorgänge veröffentlicht wurden. Dies ist eine optionale Eigenschaft, die der Treiber als Ereignisparameter angeben kann. Clients verwenden diesen Wert in der Regel, um ihre Ereignisbehandlung zu optimieren. Wenn der Client z. B. ein Objekt löscht, kann sein Ereignishandler das resultierende Ereignis ignorieren, da er weiß, dass er bereits die entsprechende Aktion ausgeführt hat (z. B. hat die Sicht in dem Thread aktualisiert, der den Löschzugriff ausgegeben hat).
MINDESTGRÖßE _ DES WPD-CLIENTERGEBNISPUFFERS _ _ _ _ VT _ UI4 Gibt die minimale Puffergröße (in Bytes) für das Senden von Befehlen an den Treiber an. Clients können diese Option verwenden, um die Mindestgröße des internen Puffers zu empfehlen, der zum Senden von Befehlen an den Treiber verwendet wird. Dies kann zu einem geringeren Speicherbedarf für Clients führen, die nur Befehle mit kleinen Datengrößen senden, z. B. das Abrufen oder Festlegen von Eigenschaften. Der Treiber kann diese Puffergröße überschreiben, indem er PortableDeviceResultsBufferMin im Abschnitt Geräteparameter festlegen. Diese Puffergröße muss 1024 oder höher sein. Wenn weder der Client noch der Treiber die Puffergröße festlegen, wird standardmäßig 1 MB verwendet.
WPD CLIENT MANUAL CLOSE ON DISCONNECT (MANUELLES SCHLIEßEN DES WPD-CLIENTS _ BEI TRENNUNG _ DER _ _ _ VERBINDUNG) VT _ BOOL Eine erweiterte Option für Clients, die IPortableDevice::Close oder IPortableDeviceService::Close für jedes getrennte Objekt manuell aufrufen, anstatt sich dafür auf die API zu verlassen. FALSE wird angenommen, wenn der Client diesen Parameter nicht angibt. Dies ist die empfohlene Standardeinstellung, wenn der Client nicht auf WM _ DEVICECHANGE-Nachrichten lausiert. Clients, die diese Option angeben, lauschen in der Regel auf WM _ DEVICECHANGE-Nachrichten für das Gerät und schließen dann die IPortableDevice- und IPortableDeviceService-Instanzen bei der Trennung der Gerätetrennung manuell. Clients, die diese Option auswählen, müssen die Lebensdauer jeder IPortableDevice- und IPortableDeviceService-Instanz sorgfältig verwalten, indem sie diese Objekte freigeben, wenn das Gerät getrennt wird. Anderst führt dies zu Lecks im WUDFHost.exe für den Treiber.

Requirements (Anforderungen)

Anforderung Wert
Header
PortableDevice.h

Weitere Informationen

WPD-Eigenschaften und -Attribute