Fungsi panggilan balik PFNAVCINTERSECTHANDLER (avc.h)

  • Artikel

Handler intersect AV/C menentukan apakah rentang data kompatibel. Ini adalah fungsi yang ditentukan pengguna berdasarkan prototipe berikut:

Sintaks

typedef NTSTATUS ( *PFNAVCINTERSECTHANDLER)(
  _In_      PVOID        Context,
  _In_      ULONG        PinId,
  _In_      PKSDATARANGE CallerDataRange,
  _In_      PKSDATARANGE DescriptorDataRange,
  _In_      ULONG        DataBufferSize,
  _Out_opt_ PVOID        Data,
  _Out_     PULONG       ReportedDataSize
);

Parameter

[in] Context

Nilai opsional yang diharapkan oleh handler intersect. Nilai ini disediakan oleh driver subunit (jika driver subunit menyediakan penghandel berpotongan), atau oleh driver yang lebih rendah yang menyediakan handler berpotongan.

[in] PinId

Menentukan offset (atau ID) pin tempat persimpangan sedang dilakukan.

[in] DataRange

[in] MatchingDataRange

[in] DataBufferSize

Ukuran buffer yang diteruskan oleh anggota Data . Jika ini bukan nol, maka handler intersect harus mencoba mengembalikan format data yang dihasilkan dari sepasang rentang data yang cocok. Jika ini nol, maka handler intersect harus memberikan ukuran buffer yang diperlukan di ReportedDataSize, dan mengembalikan STATUS_BUFFER_OVERFLOW.

[out, optional] Data

Buffer opsional untuk menerima format data yang dihasilkan dari sepasang rentang data yang cocok. Anggota ini diabaikan jika DataBufferSize adalah nol.

[out] DataSize

Menampilkan nilai

Handler intersect harus mengembalikan STATUS_SUCCESS jika rentang data kompatibel, dan ada cukup ruang buffer untuk mengembalikan format yang dihasilkan.

Menampilkan kode Deskripsi
STATUS_NO_MATCH Rentang data tidak kompatibel.
STATUS_INTERNAL_ERROR Ada ketidakcocokan ukuran format yang tidak terduga.
STATUS_BUFFER_OVERFLOW Handler intersect mengembalikan ukuran buffer yang diperlukan melalui anggota ReportedDataSize .
STATUS_BUFFER_TOO_SMALL Handler berpotongan tidak disediakan dengan buffer yang cukup besar untuk menahan format yang dihasilkan. Handler intersect harus dipanggil lagi dengan DataBufferSize diatur ke nol untuk menentukan ukuran buffer yang diperlukan.
STATUS_INSUFFICIENT_RESOURCES Alokasi buffer internal gagal.

Keterangan

Handler intersect AV/C ditentukan pengguna, berdasarkan prototipe fungsi di atas.

Handler digunakan bersama dengan kode fungsi AVC_FUNCTION_GET_PIN_DESCRIPTOR . Tujuan handler adalah untuk mencocokkan format data pin yang identik dan mengembalikannya ke pemanggil.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header avc.h (termasuk Avc.h)

Lihat juga