Création d’une instance File-Handler dans une DLL

[La fonctionnalité associée à cette page, Gestionnaires de fichiers personnalisés et de flux, est une fonctionnalité héritée. Il a été remplacé par la classe MediaStreamSource. La classe MediaStreamSource a été optimisée pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise la classe MediaStreamSource au lieu des gestionnaires de fichiers personnalisés et de flux, dans la mesure du possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Lorsqu’une application spécifie votre DLL de gestionnaire de fichiers ou votre gestionnaire de flux, le système la recherche dans le Registre par son identificateur de classe et la charge. Le système appelle ensuite la fonction DllGetClassObject de la DLL pour créer un instance du gestionnaire de fichiers ou de flux. L’exemple suivant (écrit en C++) montre comment un gestionnaire de fichiers crée un instance.

// Main DLL entry point. 
STDAPI DllGetClassObject(const CLSID FAR& rclsid, 
    const IID FAR& riid, void FAR* FAR* ppv) 
{ 
    HRESULT hresult; 
    hresult = CAVIFileCF::Create(rclsid, riid, ppv); 
    return hresult; 
} 
HRESULT CAVIFileCF::Create(const CLSID FAR&   rclsid, 
    const IID FAR& riid, void FAR* FAR*   ppv) 
{ 
// The following is the class factory creation and not an 
// actual PAVIFile. 
    CAVIFileCF FAR*   pAVIFileCF; 
    IUnknown FAR*   pUnknown; 
    HRESULT hresult; 
 
// Create the instance. 
    pAVIFileCF = new FAR CAVIFileCF(rclsid, &pUnknown); 
    if (pAVIFileCF == NULL) 
        return ResultFromScode(E_OUTOFMEMORY); 
 
// Set the interface pointer. 
    hresult = pUnknown->QueryInterface(riid, ppv); 
    if (FAILED(GetScode(hresult))) 
        delete pAVIFileCF; 
    return hresult; 
}