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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| IRQL | PASSIVE_LEVEL |