LPFN_RIODEREGISTERBUFFER fungsi panggilan balik (mswsock.h)

Fungsi RIODeregisterBuffer membatalkan pendaftaran buffer terdaftar yang digunakan dengan ekstensi I/O terdaftar Winsock.

Sintaks

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

Parameter

BufferId

Deskriptor yang mengidentifikasi buffer terdaftar.

Nilai kembali

Tidak ada

Keterangan

Fungsi RIODeregisterBuffer membatalkan pendaftaran buffer terdaftar. Ketika buffer dibatalkan pendaftarannya, aplikasi menunjukkan bahwa itu dilakukan dengan pengidentifikasi buffer yang diteruskan dalam parameter BufferId . Setiap panggilan berikutnya ke fungsi lain yang mencoba menggunakan pengidentifikasi buffer ini akan gagal.

Jika buffer yang masih digunakan dibatalkan pendaftarannya, hasilnya tidak terdefinisi. Ini dianggap sebagai kesalahan serius. Dalam struktur RIORESULT yang dikembalikan oleh fungsi RIODequeueCompletion , status tidak akan berubah dari status normal. Pengembang aplikasi dapat mendeteksi kondisi kesalahan ini menggunakan alat Pemverifikasi Aplikasi.

Jika pengidentifikasi buffer tidak valid diteruskan dalam parameter BufferId , ini diabaikan oleh fungsi RIODeregisterBuffer .

Catatan

Penunjuk fungsi ke fungsi RIODeregisterBuffer harus diperoleh pada durasi dengan melakukan panggilan ke fungsi WSAIoctl dengan opcode SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER yang ditentukan. Buffer input yang diteruskan ke fungsi WSAIoctl harus berisi WSAID_MULTIPLE_RIO, pengidentifikasi unik global (GUID) yang nilainya mengidentifikasi fungsi ekstensi I/O terdaftar Winsock. Setelah berhasil, output yang dikembalikan oleh fungsi WSAIoctl berisi pointer ke struktur RIO_EXTENSION_FUNCTION_TABLE yang berisi pointer ke fungsi ekstensi I/O terdaftar Winsock. IOCTL SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER didefinisikan dalam file header Ws2def.h. GUID WSAID_MULTIPLE_RIO ditentukan dalam file header Mswsock.h .

 

Windows Phone 8: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

Persyaratan

Persyaratan	Nilai
Header	mswsock.h