IPortClsNotifications::AllocNotificationBuffer 메서드(portcls.h)
지정된 크기의 버퍼를 지정된 메모리 풀에 할당하여 알림을 보내는 데 사용할 수 있도록 오디오 모듈과 UWP 앱 간의 통신을 허용합니다.
오디오 모듈에 대한 자세한 내용은 오디오 모듈 검색 구현을 참조하세요.
구문
NTSTATUS AllocNotificationBuffer(
[in] POOL_TYPE PoolType,
[in] USHORT NumberOfBytes,
[out] PPCNOTIFICATION_BUFFER *NotificationBuffer
);
매개 변수
[in] PoolType
개체를 할당할 메모리 풀의 형식을 지정합니다( POOL_TYPE 참조). 권장되는 값은 NonPagedPoolNx 또는 PagedPool입니다. 메모리 풀 유형 선택도 IRQL 수준에 따라 달라집니다. DISPATCH_LEVEL 실행 중인 경우 메모리는 페이징되지 않아야 합니다.
[in] NumberOfBytes
할당할 바이트 수입니다.
[out] NotificationBuffer
메서드가 할당된 알림의 주소를 쓰는 PCNOTIFICATION_BUFFER 대한 포인터입니다.
반환 값
STATUS_SUCCESS – 드라이버가 알림 버퍼를 할당할 수 있었습니다.
STATUS_INVALID_PARAMETER – 드라이버가 다른 오류 상태 인스턴스에 대한 특정 사례 외에 다른 매개 변수가 유효하지 않은 경우를 발견하면 이 오류를 반환합니다.
추가 표준 상태 코드가 반환될 수 있습니다. 예를 들어 필요한 버퍼를 할당할 수 없는 경우 STATUS_INSUFFICIENT_RESOURCES 반환됩니다.
설명
AllocNotificationBuffer의 호출자는 IRQL <= DISPATCH_LEVEL 실행 중이어야 합니다. 드라이버 작성기가 IRQL = DISPATCH_LEVEL 이 루틴을 호출하는 경우 NotificationStructure는 페이지가 없는 메모리에서 할당되어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1703 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | portcls.h(Portcls.h 포함) |
| 라이브러리 | Portcls.lib |
| IRQL | <= DISPATCH_LEVEL(주의 섹션 참조) |