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 |
|