RxCeBuildConnection-Funktion (rxce.h)
RxCeBuildConnection stellt eine Verbindung zwischen einer lokalen RDBSS-Verbindungsadresse und einer bestimmten Remoteadresse her.
Syntax
NTSTATUS RxCeBuildConnection(
IN PRXCE_ADDRESS pLocalAddress,
[in] IN PRXCE_CONNECTION_INFORMATION pConnectionInformation,
[in] IN PRXCE_CONNECTION_EVENT_HANDLER pHandler,
[in] IN PVOID pEventContext,
[in, out] IN OUT PRXCE_CONNECTION pConnection,
[in, out] IN OUT PRXCE_VC pVc
);
Parameter
pLocalAddress
Ein Zeiger auf die lokale RDBSS-Verbindungsmoduladresse.
[in] pConnectionInformation
Ein Zeiger auf die Verbindungsinformationen, die die Remoteadresse angibt.
[in] pHandler
Ein Zeiger auf den Ereignishandler für die Verarbeitung von Empfangsanzeigen.
[in] pEventContext
Ein Zeiger auf den Kontextparameter, der an den Ereignishandler übergeben und für Indikationen verwendet wird.
[in, out] pConnection
Bei eingabe enthält dieser Parameter einen Zeiger auf eine nicht initialisierte RDBSS-Verbindung. Bei der Ausgabe, wenn dieser Aufruf erfolgreich ist, wird die Verbindung ordnungsgemäß initialisiert.
[in, out] pVc
Bei der Eingabe enthält dieser Parameter einen Zeiger auf einen nicht initialisierten virtuellen RDBSS-Schaltkreis. Wenn dieser Aufruf erfolgreich ist, wird der virtuelle Schaltkreis der Verbindung zugeordnet, und der virtuelle Schaltkreis wird ordnungsgemäß initialisiert.
Rückgabewert
RxCeBuildConnection- gibt STATUS_SUCCESS bei Erfolg oder einer der folgenden Fehlercodes für Fehler zurück:
Rückgabecode | Beschreibung |
---|---|
|
Fehler bei der Zuordnung des nicht ausseitigen Poolspeichers, der von dieser Routine benötigt wird. |
|
Einer der Parameter, die an diese Routine übergeben wurden, war ungültig. |
Bemerkungen
RxCeBuildConnection- sollte im Kontext eines Systemarbeitsthreads aufgerufen werden.
Wenn RxCeBuildConnection- erfolgreich ist, werden die Datenmmber in der RXCE_CONNECTION Struktur, auf die der pConnection-Parameter verweist, und die Datenmber in der RXCE_VC-Struktur, auf die der pVc--Parameter verweist, ordnungsgemäß initialisiert, und der virtuelle Schaltkreis wird der Verbindung zugeordnet.
RXCE_CONNECTION_INFORMATION ist ein Typedef für eine TDI_CONNECTION_INFORMATION-Struktur.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Desktop |
Header- | rxce.h (include Rxce.h) |
IRQL- | <= APC_LEVEL |