Klaim perangkat Titik Layanan dan mengaktifkan model

Gunakan klaim perangkat Point of Service dan aktifkan API untuk mengklaim perangkat dan mengaktifkannya untuk operasi I/O.

Mengklaim untuk penggunaan eksklusif

Setelah membuat objek perangkat PointOfService, Anda harus mengklaimnya menggunakan metode klaim yang sesuai untuk jenis perangkat sebelum Anda dapat menggunakan perangkat untuk input atau output. Klaim memberikan akses eksklusif aplikasi ke banyak fungsi perangkat untuk memastikan bahwa satu aplikasi tidak mengganggu penggunaan perangkat oleh aplikasi lain. Hanya satu aplikasi pada satu waktu yang dapat mengklaim perangkat PointOfService untuk penggunaan eksklusif.

API yang digunakan untuk mengklaim/merilis

Mengaktifkan perangkat untuk operasi I/O

Tindakan klaim menetapkan hak eksklusif untuk perangkat, tetapi tidak memasukkannya ke dalam status operasional. Untuk menerima peristiwa atau melakukan operasi output apa pun, Anda harus mengaktifkan perangkat menggunakan EnableAsync. Sebaliknya, Anda dapat memanggil DisableAsync untuk berhenti mendengarkan peristiwa dari perangkat atau berhenti melakukan output. Anda juga dapat menggunakan IsEnabled untuk menentukan status perangkat Anda.

API yang digunakan aktifkan/nonaktifkan

Tampilan Baris ¹ tidak mengharuskan Anda mengaktifkan perangkat secara eksplisit untuk operasi I/O. Pengaktifan dilakukan secara otomatis oleh API PointOfService LineDisplay yang melakukan I/O.

Sampel kode: klaim dan aktifkan

Sampel ini menunjukkan cara mengklaim perangkat pemindai kode batang setelah Anda berhasil membuat objek pemindai kode batang.

    BarcodeScanner barcodeScanner = await BarcodeScanner.FromIdAsync(DeviceId);

    if(barcodeScanner != null)
    {
        // after successful creation, claim the scanner for exclusive use 
        claimedBarcodeScanner = await barcodeScanner.ClaimScannerAsync();

        if(claimedBarcodeScanner != null)
        {
            // after successful claim, enable scanner for data events to fire
            await claimedBarcodeScanner.EnableAsync();
        }
        else
        {
            Debug.WriteLine("Failure to claim barcodeScanner");
        }
    }
    else
    {
        Debug.WriteLine("Failure to create barcodeScanner object");
    }
    

Negosiasi klaim

Karena Windows adalah lingkungan multi-tugas, dimungkinkan bagi beberapa aplikasi di komputer yang sama untuk memerlukan akses ke periferal dengan cara yang kooperatif. API PointOfService menyediakan model negosiasi yang memungkinkan beberapa aplikasi berbagi periferal yang terhubung ke komputer.

Ketika aplikasi kedua di komputer yang sama meminta Klaim untuk periferal PointOfService yang sudah diklaim oleh aplikasi lain, pemberitahuan peristiwa ReleaseDeviceRequested diterbitkan. Aplikasi dengan klaim aktif harus merespons pemberitahuan peristiwa dengan memanggil RetainDevice jika aplikasi saat ini menggunakan perangkat untuk menghindari kehilangan klaim.

Jika aplikasi dengan klaim aktif tidak segera merespons dengan RetainDevice , diasumsikan bahwa aplikasi telah ditangguhkan atau tidak memerlukan perangkat dan klaim dicabut dan diberikan ke aplikasi baru.

Langkah pertama adalah membuat penanganan aktivitas yang merespons peristiwa ReleaseDeviceRequested dengan RetainDevice.

    /// <summary>
    /// Event handler for the ReleaseDeviceRequested event which occurs when 
    /// the claimed barcode scanner receives a Claim request from another application
    /// </summary>
    void claimedBarcodeScanner_ReleaseDeviceRequested(object sender, ClaimedBarcodeScanner myScanner)
    {
        // Retain exclusive access to the device
        myScanner.RetainDevice();
    }

Selanjutnya, daftarkan penanganan aktivitas yang terkait dengan perangkat yang Diklaim

    BarcodeScanner barcodeScanner = await BarcodeScanner.FromIdAsync(DeviceId);

    if(barcodeScanner != null)
    {
        // after successful creation, claim the scanner for exclusive use 
        claimedBarcodeScanner = await barcodeScanner.ClaimScannerAsync();

        if(claimedBarcodeScanner != null)
        {
            // register a release request handler to prevent loss of scanner during active use
            claimedBarcodeScanner.ReleaseDeviceRequested += claimedBarcodeScanner_ReleaseDeviceRequested;

            // after successful claim, enable scanner for data events to fire
            await claimedBarcodeScanner.EnableAsync();          
        }
        else
        {
            Debug.WriteLine("Failure to claim barcodeScanner");
        }
    }
    else
    {
        Debug.WriteLine("Failure to create barcodeScanner object");
    }

API yang digunakan untuk negosiasi klaim