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
PortableDevice.h