LPFN_RIODEREGISTERBUFFER 콜백 함수(mswsock.h)

RIODeregisterBuffer 함수는 Winsock 등록 I/O 확장에 사용되는 등록된 버퍼를 등록 취소합니다.

구문

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

매개 변수

BufferId

등록된 버퍼를 식별하는 설명자입니다.

반환 값

없음

설명

RIODeregisterBuffer 함수는 등록된 버퍼를 등록 취소합니다. 버퍼가 등록 취소되면 애플리케이션은 BufferId 매개 변수에 전달된 버퍼 식별자를 사용하여 수행되었음을 나타냅니다. 이 버퍼 식별자를 사용하려고 하는 다른 함수에 대한 후속 호출은 실패합니다.

여전히 사용 중인 버퍼의 등록이 취소된 경우 결과는 정의되지 않습니다. 심각한 오류로 간주됩니다. RIODequeueCompletion 함수에서 반환된 RIORESULT 구조체에서 상태 일반 상태 변경되지 않습니다. 애플리케이션 개발자는 Application Verifier 도구를 사용하여 이 오류 조건을 검색할 수 있습니다.

BufferId 매개 변수에 잘못된 버퍼 식별자가 전달되면 RIODeregisterBuffer 함수에서 무시됩니다.

참고

지정된 SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER opcode를 사용하여 WSAIoctl 함수를 호출하여 런타임에 RIODeregisterBuffer 함수에 대한 함수 포인터를 가져와야 합니다. WSAIoctl 함수에 전달된 입력 버퍼에는 값이 Winsock 등록 I/O 확장 함수를 식별하는 GUID(Globally Unique Identifier)인 WSAID_MULTIPLE_RIO 포함되어야 합니다. 성공하면 WSAIoctl 함수에서 반환된 출력에는 Winsock 등록 I/O 확장 함수에 대한 포인터가 포함된 RIO_EXTENSION_FUNCTION_TABLE 구조체에 대한 포인터가 포함됩니다. SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL은 Ws2def.h 헤더 파일에 정의되어 있습니다. WSAID_MULTIPLE_RIO GUID는 Mswsock.h 헤더 파일에 정의되어 있습니다.

 

Windows Phone 8: 이 함수는 Windows Phone 8 이상에서 Windows Phone 스토어 앱에서 지원됩니다.

Windows 8.1 및 Windows Server 2012 R2: 이 함수는 Windows 8.1, Windows Server 2012 R2 이상에서 Windows 스토어 앱에서 지원됩니다.

요구 사항

요구 사항	값
헤더	mswsock.h