KsCreatePin-Funktion (ks.h)

Die KsCreatePin-Funktion übergibt eine Verbindungsanforderung an ein Gerät und erstellt einen Pin instance. Diese Funktion kann nur bei PASSIVE_LEVEL für Kernelmodusclients aufgerufen werden.

Syntax

KSDDKAPI NTSTATUS KsCreatePin(
  [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

Die KsCreatePin-Funktion gibt STATUS_SUCCESS zurück, wenn die Verbindung erfolgreich war, oder sie gibt einen Fehler zurück, wenn die Verbindung fehlgeschlagen ist. Darüber hinaus kann dieser Win32-Fehlercode (von Winerror.h) zurückgegeben werden:

Hinweise

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 KsCreatePin einen Pin, mit dem der Aufrufer Anforderungen an den in Connect-FilterHandle> angegebenen Streamingtreiber senden kann. Connect-PinId> bestimmt den Pintyp des zu erstellenden Pins.

Anforderungen

Weitere Informationen

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT