KsCreatePin2, fonction (ks.h)
Transmet une demande de connexion à un appareil, en créant un instance d’épingle.
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 à l’origine de la demande de création et l’emplacement où la connexion se produira.
[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 d’une structure de données KSDATAFORMAT , décrivant le format de données demandé pour la connexion.
[in] DesiredAccess
Spécifie l’accès souhaité à l’épingle. Il s’agit généralement GENERIC_READ ou GENERIC_WRITE. Pour les données entrant dans la broche, cette valeur doit être définie sur GENERIC_WRITE, et pour les données sortant de l’épingle, cette valeur doit être définie sur GENERIC_READ quelle que soit la méthode de communication.
[out] ConnectionHandle
Spécifie le handle de connexion passé. La routine remplit ce paramètre avec un handle pour l’objet file de la connexion créée. Cette valeur peut ensuite être utilisée pour se déconnecter avec la fonction CloseHandle .
Valeur retournée
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 vers l’objet de diffusion en continu du noyau. En outre, la fonction Com (Component Object Model) CoInitialize doit être appelée avant que cette fonction ne 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> a la valeur NULL, KsCreatePin2 crée une broche que l’appelant peut utiliser pour envoyer des requêtes au pilote de streaming spécifié dans Connect-FilterHandle>. Connect-PinId> détermine le type d’épingle à créer.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 |
| Serveur minimal pris en charge | Windows Server 2012 |
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| IRQL | PASSIVE_LEVEL |