SpbTargetGetFileObject-Funktion (spbcx.h)

  • Artikel

Die SpbTargetGetFileObject-Methode akzeptiert als Eingabeparameter ein SPBTARGET-Handle für ein geöffnetes Zielgerät und gibt ein WDFFILEOBJECT-Handle an dieses Ziel zurück.

Syntax

WDFFILEOBJECT SpbTargetGetFileObject(
  [in] SPBTARGET Target
);

Parameter

[in] Target

Ein SPBTARGET-Handle für ein Zielgerät auf dem Bus.

Rückgabewert

SpbTargetGetFileObject gibt ein WDFFILEOBJECT-Handle an ein geöffnetes Zielgerät auf dem Bus zurück. Die Methode gibt NULL zurück, wenn die Verbindung mit dem Ziel durch einen EvtSpbTargetDisconnect-Ereignisrückruf geschlossen wurde.

Hinweise

Ihr Controllertreiber kann diese Methode aufrufen, um ein WDFFILEOBJECT-Handle für ein geöffnetes Zielgerät auf dem Bus abzurufen. Der SPB-Controllertreiber kann dieses Handle dann als Eingabeparameter für WDF-Methoden verwenden, die ein solches Handle erfordern.

SpbTargetGetFileObject gibt NULL nur zurück, wenn das WDFFILEOBJECT-Handle für das Ziel geschlossen wurde. Bevor es geschlossen wurde, hat der SPB-Controllertreiber einen zusätzlichen Verweis auf das SBPTARGET-Objekt verwendet, um seine Lebensdauer zu verlängern.

Wenn die Verbindung geschlossen wurde und der SPB-Controllertreiber keine Verweise auf das SPBTARGET-Objekt enthält, ist das SBPTARGET-Handle nicht mehr gültig. Das Übergeben eines ungültigen Handles an SpbTargetGetFileObject verursacht eine Fehlerüberprüfung.

Nachdem SpbTargetGetFileObject ein WDFFILEOBJECT-Handle zurückgegeben hat, gibt es keine Garantie dafür, dass die Zielverbindung geöffnet bleibt, es sei denn, ein anderes Objekt (z. B. eine aktive E/A-Anforderung) enthält einen Verweis auf das WDFFILEOBJECT-Objekt, um ein unerwartetes Schließen zu verhindern. Diese Methode ist am nützlichsten und wird daher wahrscheinlich aufgerufen, wenn die Zielverbindung garantiert geöffnet ist. In der Regel treten solche Aufrufe während der Rückrufe EvtSpbTargetConnect und EvtSpbTargetDisconnect sowie während der Verarbeitung von E/A-Anforderungen auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.
Zielplattform Universell
Header spbcx.h
Bibliothek Spbcxstubs.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

EvtSpbTargetConnect

EvtSpbTargetDisconnect

SPBTARGET