WPD _ COMMAND _ DEVICE _ HINTS _ GET _ CONTENT _ LOCATION Command
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 für einen Client schneller bereitgestellt, um zu ermitteln, wo ein Gerät bestimmte Objekte speichert, als durch brute-Objektenumeration.
Befehlskategorie
_GERÄTEHINWEISE DER KATEGORIE WPD _ _
Parameter
Der Treiber erwartet die folgenden Parameter.
| Parameter | VarType | BESCHREIBUNG |
|---|---|---|
| _ _ _ WPD-EIGENSCHAFTENGERÄTEHINWEISE _ _ INHALTSTYP | 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 Aufrufer WPD _ CONTENT _ TYPE _ IMAGE. Eine Liste der Objekttypen, die von Windows Portable Devices definiert werden, finden Sie unter Anforderungen für Objekte. |
Rückgabewert
Als Ergebnisse des Treibers werden erwartet:
| Ergebnis | VarType | BESCHREIBUNG |
|---|---|---|
| _WPD-EIGENSCHAFTENGERÄTEHINWEISE _ _ ZU _ _ INHALTSSPEICHERORTEN | VT _ UNKNOWN | Erforderlich. Eine IPortableDevicePropVariantCollection vom Typ VT _ LPWSTR-Werte, 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 dürfen Objekte anderer Inhaltstypen enthalten oder nicht. Informationen zu Ordnereinschränkungen finden Sie in der WPD _ FOLDER CONTENT _ TYPES _ _ ALLOWED-Eigenschaft. |
| _WPD-EIGENSCHAFT _ COMMON _ HRESULT | _VT-FEHLER | Erforderlich. Ein HRESULT, das den Erfolg oder Fehler bei der Verarbeitung des Befehls angibt. Wenn der Aufrufer eine ungültige Anforderung stellt, sollte der Treiber HRESULT _ FROM _ WIN32(ERROR _ NOT _ SUPPORTED) zurückgeben und muss keine anderen Ergebniswerte zurückgeben. Fehlercodes umfassen Windows Fehlercodes für portable Geräte oder andere geeignete Fehlercodes. |
| ALLGEMEINER _ _ _ _ TREIBERFEHLERCODE _ FÜR WPD-EIGENSCHAFTEN | VT _ UI4 | Optional. Ein treiberspezifischer Fehlercode. Dies wird in der Regel nur für Treibertests verwendet, oder wenn Treiber, Gerät und Client alle zusammen entworfen wurden. |
Aufrufen von Methoden
Kann nur direkt mit IPortableDevice::SendCommandaufgerufen werden.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Header |
|