WS_CREATE_ENCODER_CALLBACK Rückruffunktion (webservices.h)

Artikel
03/03/2024

Behandelt das Erstellen eines Encoder-instance.

Syntax

WS_CREATE_ENCODER_CALLBACK WsCreateEncoderCallback;

HRESULT WsCreateEncoderCallback(
  [in]           void *createContext,
  [in]           WS_WRITE_CALLBACK writeCallback,
  [in]           void *writeContext,
                 void **encoderContext,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] createContext

Der createContext, der in der WS_CHANNEL_ENCODER angegeben wurde, die bei der Kanalerstellung verwendet wurde.

[in] writeCallback

Die Funktion, die zum Schreiben der Nachrichtendaten verwendet werden soll. Dieser Rückruf sollte nur als Reaktion auf die WS_ENCODER_START_CALLBACK, WS_ENCODER_ENCODE_CALLBACK und WS_ENCODER_END_CALLBACK Rückrufe verwendet werden.

[in] writeContext

Der Schreibkontext, der an die angegebene WS_WRITE_CALLBACK übergeben werden soll.

encoderContext

Gibt den Encoder instance zurück. Dieser Wert wird an alle Encoderrückrufe übergeben.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Rückruffunktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Der Kanal erstellt bei Bedarf Encoderinstanzen. Jeder Encoder instance wird auf Singlethread-Weise aufgerufen. Ein einzelner Encoder instance sollte jedoch nicht davon ausgehen, dass alle Nachrichten von einem Kanal angezeigt werden, da der Kanal möglicherweise mehrere Encoderinstanzen für die Verarbeitung von Nachrichten verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h

Freigeben über