KsCreatePin2, fonction (ks.h)
Transmet une demande de connexion à un appareil, en créant une instance de broche.
Prise en charge à partir de Windows 8.
Syntaxe
KSDDKAPI HRESULT KsCreatePin2(
[in] HANDLE FilterHandle,
[in] PKSPIN_CONNECT Connect,
[in] ACCESS_MASK DesiredAccess,
[out] PHANDLE ConnectionHandle
);
Paramètres
[in] FilterHandle
Spécifie le handle du filtre qui lance la demande de création et où la connexion se produit.
[in] Connect
Pointeur vers une structure KSPIN_CONNECT qui contient des paramètres pour la connexion demandée. Cette opération doit être suivie en mémoire par un KSDATAFORMAT structure de données, décrivant le format de données demandé pour la connexion.
[in] DesiredAccess
Spécifie l’accès souhaité à l’épingle. Cela est généralement GENERIC_READ ou GENERIC_WRITE. Pour que les données qui circulent dans la broche, cette valeur soit définie sur GENERIC_WRITE, et pour les données sortant de la broche, elles doivent être définies sur GENERIC_READ quelle que soit la méthode de communication.
[out] ConnectionHandle
Spécifie le handle de connexion passé. La routine le remplit avec un handle pour l’objet de fichier de la connexion créée. Cette valeur peut ensuite être utilisée pour se déconnecter avec la fonction CloseHandle.
Valeur de retour
Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.
Remarques
Il s’agit d’une nouvelle version de la fonction KsCreatePin et utilise le répartiteur d’appareils pour créer le handle à l’objet de diffusion en continu du noyau. En outre, le modèle objet de composant (COM) CoInitialize fonction doit être appelé avant que cette fonction soit appelée.
La routine envoie une requête IRP_MJ_CREATE au pilote. Le pilote accepte la requête uniquement si l’interface, le support et le format de données sont compatibles.
Si Connect-> PinToHandle est NULL, KsCreatePin2 crée une broche que l’appelant peut utiliser pour envoyer des requêtes au pilote de diffusion en continu spécifié dans Connect->FilterHandle. Connect->PinId détermine le type de broche à créer.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| IRQL | PASSIVE_LEVEL |