KsCreatePin2-Funktion (ks.h)

Artikel
02/07/2025

Übergibt eine Verbindungsanforderung an ein Gerät, wodurch eine Pininstanz erstellt wird.

Wird ab Windows 8 unterstützt.

Syntax

KSDDKAPI HRESULT KsCreatePin2(
  [in]  HANDLE         FilterHandle,
  [in]  PKSPIN_CONNECT Connect,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        ConnectionHandle
);

Parameter

[in] FilterHandle

Gibt das Handle des Filters an, der die Erstellungsanforderung initiiert und wo die Verbindung hergestellt wird.

[in] Connect

Zeigen Sie auf eine KSPIN_CONNECT-Struktur, die Parameter für die angeforderte Verbindung enthält. Dies sollte im Arbeitsspeicher durch eine KSDATAFORMAT- Datenstruktur gefolgt werden, die das für die Verbindung angeforderte Datenformat beschreibt.

[in] DesiredAccess

Gibt den Zugriff an, der für den Pin gewünscht ist. Dies ist in der Regel GENERIC_READ oder GENERIC_WRITE. Für Daten, die in den Pin fließen, sollte dieser Wert auf GENERIC_WRITEfestgelegt werden, und für Daten, die aus dem Pin fließen, sollte dies unabhängig von der Kommunikationsmethode auf GENERIC_READ festgelegt werden.

[out] ConnectionHandle

Gibt den übergebenen Verbindungsziehpunkt an. Die Routine füllt dies mit einem Handle für das Dateiobjekt der erstellten Verbindung aus. Dieser Wert kann dann verwendet werden, um die Verbindung mit der funktion CloseHandle zu trennen.

Rückgabewert

Gibt NOERROR- zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

Dies ist eine neue Version der KsCreatePin--Funktion und verwendet den Gerätebroker, um das Handle für das Kernelstreamingobjekt zu erstellen. Darüber hinaus muss das Component Object Model (COM) CoInitialize-Funktion aufgerufen werden, bevor diese Funktion aufgerufen wird.

Die Routine sendet eine IRP_MJ_CREATE Anforderung an den Treiber. Der Treiber akzeptiert die Anforderung nur, wenn die Schnittstelle, das Medium und das Datenformat kompatibel sind.

Wenn Connect->PinToHandle-NULL-ist, erstellt KsCreatePin2 einen Pin, den der Aufrufer verwenden kann, um Anforderungen an den streamingtreiber zu senden, der in Connect->FilterHandleangegeben ist. Connect–>PinId- bestimmt den Typ der zu erstellenden Pin.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

Freigeben über