Freigeben über


Verwenden des Kontextparameters

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Einige der vom Windows Media Format SDK verwendeten Rückrufe verwenden einen Parameter namens pvContext. Die aufrufenden Objekte übergeben den Wert, den Sie in der Methode angeben, die die asynchrone Aktion gestartet hat. Wenn Sie beispielsweise IWMReader::Open aufrufen, können Sie einen Wert für pvContext übergeben. Wenn die IWMStatusCallback::OnStatus-Methode vom Reader-Objekt aufgerufen wird, um Ihre Anwendung zu benachrichtigen, dass die Datei geöffnet wurde, wird der wert, den Sie in Ihrem Open-Aufruf verwendet haben, als pvContext-Parameter von OnStatus übergeben. Dieser Kontextparameter wird für Ihre Verwendung bereitgestellt, und Sie können ihn in beliebiger Weise verwenden.

Der pvContext-Parameter wird am häufigsten verwendet, wenn mehrere Objekte denselben Rückruf gemeinsam nutzen müssen. Beispielsweise verwenden mehrere Objekte die IWMStatusCallback::OnStatus-Methode . Sie können pvContext verwenden, um es den verschiedenen Objekten zu ermöglichen, eine Implementierung von OnStatus gemeinsam zu nutzen, indem Sie einen anderen Wert für pvContext für Ihren ursprünglichen Aufruf übergeben. In Ihrer Implementierung von OnStatus können Sie die Logik für die Nachrichtenverarbeitung basierend auf dem Wert von pvContext verzweigen.

Verwenden der Rückrufmethoden