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는 페이지가 없는 메모리에서 할당되어야 합니다.

요구 사항

추가 정보

IPortClsNotifications