befehl WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION
Der befehl WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION ruft die Objekt-IDs von Ordnern ab, die ein Objekt eines angegebenen Typs enthalten können. Dieser Befehl wird als schnellere Möglichkeit für einen Client bereitgestellt, um zu ermitteln, wo ein Gerät bestimmte Objekte speichert, als durch brute-Objektaufzählung.
Befehlskategorie
WPD_CATEGORY_DEVICE_HINTS
Parameter
Der Treiber erwartet die folgenden Parameter.
| Parameter | VarType | Beschreibung |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE | VT_CLSID | Erforderlich. Der Objekttyp, für den der Aufrufer den Container suchen möchte. Um beispielsweise die Ordner der obersten Ebene zu finden, die zum Speichern von Bildern auf einer Digitalkamera verwendet werden, sendet der Anrufer WPD_CONTENT_TYPE_IMAGE. Eine Liste von Objekttypen, die von tragbaren Windows-Geräten definiert werden, finden Sie unter Anforderungen für Objekte . |
Rückgabewert
Als Ergebnisse des Treibers werden erwartet:
| Ergebnis | VarType | Beschreibung |
|---|---|---|
| WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS | VT_UNKNOWN | Erforderlich. Eine IPortableDevicePropVariantCollection vom Typ VT_LPWSTR Werte an, die die Objekt-IDs von Ordnern angeben, die Objekte des vom aufrufenden Parameter angegebenen Typs enthalten. Wenn keine Ordner gefunden werden, sollte dies eine leere Liste sein. Die durch das Ergebnis angegebenen Ordner können Objekte anderer Inhaltstypen enthalten oder nicht. Informationen zu Ordnereinschränkungen finden Sie in der WPD_FOLDER_CONTENT_TYPES_ALLOWED-Eigenschaft . |
| WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | Erforderlich. Ein HRESULT , das den Erfolg oder Fehler der Verarbeitung des Befehls angibt. Wenn der Aufrufer eine ungültige Anforderung sendet, sollte der Treiber HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) zurückgeben und muss keine anderen Ergebniswerte zurückgeben. Fehlercodes umfassen Fehlercodes für windows Portable Devices oder andere geeignete Fehlercodes. |
| WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | Optional. Ein treiberspezifischer Fehlercode. Dies wird in der Regel nur für Treibertests verwendet, oder wenn Treiber, Gerät und Client gemeinsam entwickelt wurden. |
Aufrufen von Methoden
Kann nur mit IPortableDevice::SendCommand direkt aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|