Condividi tramite

Creazione di nodi di output

  • Articolo

Un nodo di uscita rappresenta un sink di flusso all'interno di un collettore multimediale. Esistono due modi per inizializzare un nodo di output:

  • Da un puntatore alla destinazione del flusso.
  • Da un puntatore a un oggetto di attivazione per il sink multimediale.

Se si sta per caricare la topologia all'interno del percorso multimediale protetto (PMP), è necessario usare un oggetto di attivazione, in modo che il sink multimediale possa essere creato all'interno del processo protetto. Il primo approccio (usando un puntatore al sink del flusso) non funziona con PMP.

Creazione di un nodo di output da un sink di flusso

Per creare un nodo di output da un sink di flusso, eseguire le operazioni seguenti:

  1. Creare un'istanza del sink multimediale.
  2. Usa l'interfaccia IMFMediaSink del sink multimediale per ottenere un puntatore al sink di flusso desiderato. L'interfaccia IMFMediaSink include diversi metodi che restituiscono puntatori a un sink di flusso.
  3. Chiamare MFCreateTopologyNode con il flag MF_TOPOLOGY_OUTPUT_NODE per creare il nodo di output.
  4. Chiamare IMFTopologyNode::SetObject e passare un puntatore all'interfaccia IMFStreamSinkdel sink stream.
  5. Impostare l'attributo MF_TOPONODE_NOSHUTDOWN_ON_REMOVE su false (facoltativo ma consigliato).
  6. Chiamare IMFTopology::AddNode per aggiungere il nodo alla topologia.

Nell'esempio seguente viene creato e inizializzato un nodo di output da un sink di flusso.

HRESULT AddOutputNode(
    IMFTopology *pTopology,     // Topology.
    IMFStreamSink *pStreamSink, // Stream sink.
    IMFTopologyNode **ppNode    // Receives the node pointer.
    )
{
    IMFTopologyNode *pNode = NULL;
    HRESULT hr = S_OK;
    
    // Create the node.
    hr = MFCreateTopologyNode(MF_TOPOLOGY_OUTPUT_NODE, &pNode);

    // Set the object pointer.
    if (SUCCEEDED(hr))
    {
        hr = pNode->SetObject(pStreamSink);
    }

    // Add the node to the topology.
    if (SUCCEEDED(hr))
    {
        hr = pTopology->AddNode(pNode);
    }

    if (SUCCEEDED(hr))
    {
        hr = pNode->SetUINT32(MF_TOPONODE_NOSHUTDOWN_ON_REMOVE, TRUE);
    }

    // Return the pointer to the caller.
    if (SUCCEEDED(hr))
    {
        *ppNode = pNode;
        (*ppNode)->AddRef();
    }

    if (pNode)
    {
        pNode->Release();
    }
    return hr;
}

Quando l'applicazione arresta la sessione multimediale, la sessione multimediale arresta automaticamente il dispositivo di riproduzione multimediale. Pertanto, non è possibile riutilizzare il sink multimediale con un'altra istanza della sessione multimediale.

Creazione di un nodo di output da un oggetto di attivazione

Qualsiasi sink multimediale attendibile deve fornire un oggetto di attivazione, in modo che il sink multimediale possa essere creato all'interno del processo protetto. Per altre informazioni, vedere Oggetti di Attivazione. La funzione specifica che crea l'oggetto di attivazione dipenderà dalla destinazione multimediale.

Per creare un nodo di output da un oggetto di attivazione, eseguire le operazioni seguenti:

  1. Creare l'oggetto di attivazione e ottenere un puntatore all'interfaccia IMFActivate dell'oggetto di attivazione.
  2. Chiamare MFCreateTopologyNode con il flag MF_TOPOLOGY_OUTPUT_NODE per creare il nodo di output.
  3. Facoltativamente, impostare l'attributo MF_TOPONODE_STREAMID nel nodo per specificare l'identificatore del flusso del sink di stream. Se si omette questo attributo, il nodo usa per impostazione predefinita il sink di flusso 0.
  4. Impostare l'attributo MF_TOPONODE_NOSHUTDOWN_ON_REMOVE su TRUE (facoltativo ma consigliato).
  5. Chiamare IMFTopologyNode::SetObject e passare il puntatore IMFActivate.
  6. Chiamare IMFTopology::AddNode per aggiungere il nodo alla topologia.

Nell'esempio che segue viene creato e inizializzato un nodo di output da un oggetto di attivazione.

// Add an output node to a topology.
HRESULT AddOutputNode(
    IMFTopology *pTopology,     // Topology.
    IMFActivate *pActivate,     // Media sink activation object.
    DWORD dwId,                 // Identifier of the stream sink.
    IMFTopologyNode **ppNode)   // Receives the node pointer.
{
    IMFTopologyNode *pNode = NULL;

    // Create the node.
    HRESULT hr = MFCreateTopologyNode(MF_TOPOLOGY_OUTPUT_NODE, &pNode);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the object pointer.
    hr = pNode->SetObject(pActivate);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the stream sink ID attribute.
    hr = pNode->SetUINT32(MF_TOPONODE_STREAMID, dwId);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pNode->SetUINT32(MF_TOPONODE_NOSHUTDOWN_ON_REMOVE, FALSE);
    if (FAILED(hr))
    {
        goto done;
    }

    // Add the node to the topology.
    hr = pTopology->AddNode(pNode);
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppNode = pNode;
    (*ppNode)->AddRef();

done:
    SafeRelease(&pNode);
    return hr;
}

NodoTopologiaIMF

Creazione di topologie

lavandini multimediali

Topologie