KsCreatePin2-Funktion (ks.h)

Übergibt eine Verbindungsanforderung an ein Gerät und erstellt eine Anheftung instance.

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

Zeiger auf eine KSPIN_CONNECT-Struktur , die Parameter für die angeforderte Verbindung enthält. Darauf sollte im Arbeitsspeicher eine KSDATAFORMAT-Datenstruktur folgen, die das für die Verbindung angeforderte Datenformat beschreibt.

[in] DesiredAccess

Gibt den gewünschten Zugriff auf die Pin an. Dies ist in der Regel GENERIC_READ oder GENERIC_WRITE. Für Daten, die in den Pin fließen, sollte dieser Wert auf GENERIC_WRITE festgelegt 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 Verbindungshandle 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 CloseHandle-Funktion zu trennen.

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.

Hinweise

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 die ComInitialize-Funktion (Component Object Model) 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, mit dem der Aufrufer Anforderungen an den in Connect-FilterHandle> angegebenen Streamingtreiber senden kann. Connect-PinId> bestimmt den Typ des zu erstellenden Pins.

Anforderungen

Weitere Informationen

CoInitialize

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT

KsCreatePin