acxstreams.h 標頭

ACX 音訊類別延伸模組會使用此標頭。

如需詳細資訊，請參閱：

• ACX 音訊類別延伸模組概觀

• 音訊

注意

ACX 標頭和連結庫不包含在 WDK 10.0.22621.2428 (2023 年 10 月 24 日發行) ，但可在舊版中取得，以及 25000 系列組建的最新 (25000 系列組建，) WDK Insider Preview。 如需 WDK 預覽版本的詳細資訊，請參閱 安裝 Windows 驅動程式套件的預覽版本 (WDK) 。

acxstreams.h 包含下列程式設計介面：

函式

ACX_RT_STREAM_CALLBACKS_INIT ACX_RT_STREAM_CALLBACKS_INIT函式方法會初始化 ACX RT 數據流回呼。 此函式位於 acxstreams 標頭中。
ACX_RTPACKET_INIT ACX_RTPACKET_INIT初始化 ACX RT 封包結構。 此函式位於 acxstreams 標頭中。
ACX_STREAM_BRIDGE_CONFIG_INIT ACX_STREAM_BRIDGE_CONFIG_INIT函式會初始化 ACX 數據流網橋組態結構。
ACX_STREAM_CALLBACKS_INIT ACX_STREAM_CALLBACKS_INIT函式會初始化 ACX 數據流回呼。
AcxDrmAddContentHandlers AcxDrmAddContentHandlers 函式提供系統處理受保護內容的函式清單。
AcxDrmCreateContentMixed AcxCreateContentMixed 函式會建立DRM內容識別碼，以識別包含來自數個數據流混合內容的ACX音訊串流
AcxDrmDestroyContent AcxDrmDestroyContent 函式會刪除 AcxDrmCreateContentMixed 所建立的 DRM 內容識別碼。
AcxDrmForwardContentToDeviceObject AcxDrmForwardContentToDeviceObject 函式接受代表呼叫端想要轉送受保護內容的裝置物件。
AcxDrmRetrieveContentRights AcxDrmRetrieveContentRights 函式會取得指派給DRM內容識別碼的DRM內容許可權。
AcxRtStreamCreate AcxRtStreamCreate 會建立 ACX RT 型 Stream，供 OS 用來串流音訊數據。
AcxRtStreamNotifyPacketComplete 驅動程式會在封包完成時呼叫 AcxRtStreamNotifyPacketComplete。
AcxStreamAddConnections AcxStreamAddConnections 函式會在 EvtAcxCircuitCreateStream 期間將明確連線新增至新的 ACX 數據流
AcxStreamAddElements AcxStreamAddElements 可用來將數據流專案新增至 AcxStream。
AcxStreamAddEvents AcxStreamAddEvents 會使用 ACXEVENT 物件將事件新增至數據流。
AcxStreamBridgeAddStream AcxStreamBridgeAddStream 函式會將現有的數據流新增至現有的網橋。 此函式位於 acxstream 標頭中。
AcxStreamBridgeCreate AcxStreamBridgeCreate 函式會使用串流設定來建立線路的 StreamBridge。
AcxStreamBridgeGetTargetStream AcxStreamBridgeGetTargetStream 函式會取得與特定 ACXSTREAMBRIDGE 對象相關聯的數據流。
AcxStreamBridgeRemoveStream AcxStreamBridgeRemoveStream 函式會從相關聯的 ACXSTREAMBRIDGE 物件中移除指定的數據流。
AcxStreamCreate AcxStreamCreate 會建立 ACX Stream，用來控制串流行為。
AcxStreamDispatchAcxRequest AcxStreamDispatchAcxRequest 會使用 WDFREQUEST 架構要求對象來分派 ACX 要求。
AcxStreamGetCircuit AcxStreamGetCircuit 函式會傳回與數據流相關聯的 ACXCIRCUIT 物件。
AcxStreamGetElementById AcxStreamGetElementById 函式會傳回所要求專案標識碼的 ACXELEMENT 物件句柄。
AcxStreamGetElementsCount AcxStreamGetElementsCount 函式會擷取指定音訊數據流的項目數目。
AcxStreamGetNotificationId AcxStreamGetNotificationId 函式會擷取指定音訊數據流的 隨插即用 通知標識符。
AcxStreamInitAssignAcxRequestPreprocessCallback AcxStreamInitAssignAcxRequestPreprocessCallback 函式會將 AcxRequestPreprocessCallback 指派給數據流。
AcxStreamInitAssignAcxRtStreamCallbacks AcxStreamInitAssignAcxRtStreamCallbacks 函式會使用 ACXSTREAM_INIT 對象來設定 RT 回呼。
AcxStreamInitAssignAcxStreamCallbacks AcxStreamInitAssignAcxStreamCallbacks 函式會使用ACX_STREAM_CALLBACKS結構和ACXSTREAM_INIT對象來設定回呼。
AcxStreamInitAssignMethods AcxStreamInitAssignMethods 函式會使用 ACXSTREAM_INIT 物件，將方法陣列指派給數據流。
AcxStreamInitAssignProperties AcxStreamInitAssignProperties 函式會使用 ACXSTREAM_INIT 物件，將屬性陣列指派給數據流。
AcxStreamInitSetAcxRtStreamSupportsNotifications AcxStreamInitSetAcxRtStreamSupportsNotifications 函式可用來指出支持緩衝區通知。
AcxStreamResumeIo AcxStreamResumeIo 函式可用來繼續數據流的IO。
AcxStreamResumeIoActual AcxStreamResumeIoActual 函式可用來繼續數據流的 IO。
AcxStreamResumeIoWithTag AcxStreamResumeIoWithTag 函式可用來繼續數據流的 IO。
AcxStreamStopIo AcxStreamStopIo 函式可用來暫時停止數據流的IO。
AcxStreamStopIoActual AcxStreamStopIoActual 函式可用來暫時停止數據流的 IO。
AcxStreamStopIoWithTag AcxStreamStopIoWithTag 函式可用來暫時停止數據流的 IO。
DEFINE_ACXDRMRIGHTS_DEFAULT 此宏提供預設DRM許可權

回呼函式

EVT_ACX_STREAM_ALLOCATE_RTPACKETS EvtAcxStreamAllocateRtPackets 事件會告訴驅動程式為串流配置 RtPacket。
EVT_ACX_STREAM_ASSIGN_DRM_CONTENT_ID EVT_ACX_STREAM_ASSIGN_DRM_CONTENT_ID 事件會告知驅動程式指派內容標識符，以供DRM串流之用。
EVT_ACX_STREAM_FREE_RTPACKETS EvtAcxStreamFreeRtPackets 事件會告訴驅動程序釋放先前呼叫 EvtAcxStreamAllocateRtPackets 中所配置的 RtPackets。
EVT_ACX_STREAM_GET_CAPTURE_PACKET EvtAcxStreamGetCapturePacket 會告知驅動程式在最近完全填入哪個封包 (以 0 為基礎的) ，包括驅動程式開始填滿封包時的 QPC 值。
EVT_ACX_STREAM_GET_CURRENT_PACKET EvtAcxStreamGetCurrentPacket 會告訴驅動程式指出目前轉譯為硬體或目前由擷取硬體填入的封包 (以 0 為基礎的) 。
EVT_ACX_STREAM_GET_HW_LATENCY EvtAcxStreamGetHwLatency 事件會告知驅動程式為此數據流的特定線路提供數據流延遲， (整體延遲將會是不同線路) 延遲的總和。
EVT_ACX_STREAM_GET_PRESENTATION_POSITION EvtAcxStreamGetPresentationPosition 會告知驅動程式在計算目前位置時指出目前位置以及 QPC 值。
EVT_ACX_STREAM_PAUSE EvtAcxStreamPause 事件會告知驅動程式將數據流狀態從 [執行] 轉換為 [暫停]。
EVT_ACX_STREAM_PREPARE_HARDWARE EvtAcxStreamPrepareHardware 事件會告知驅動程序準備硬體以進行串流處理。
EVT_ACX_STREAM_RELEASE_HARDWARE EvtAcxStreamReleaseHardware 事件會告知驅動程式釋放為數據流配置的任何硬體，並將數據流放入 [停止] 狀態。
EVT_ACX_STREAM_RUN EvtAcxStreamRun 事件會告知驅動程式將串流狀態從 [暫停] 轉換為 [執行]。
EVT_ACX_STREAM_SET_RENDER_PACKET EvtAcxStreamSetRenderPacket 事件會告知驅動程式用戶端剛釋放的封包。

結構

ACX_RT_STREAM_CALLBACKS ACX_RT_STREAM_CALLBACKS結構會定義 RT 串流至 ACX 架構的回呼。
ACX_RTPACKET ACX_RTPACKET 結構代表單一配置的封包。 PacketBuffer 必須是 MDL。
ACX_STREAM_BRIDGE_CONFIG AcxStreamBridge 結構是由線路用來傳播串流建立、狀態轉換和端點線路串流區段之間的DRM設定。
ACX_STREAM_CALLBACKS ACX_STREAM_CALLBACKS 結構會識別串流至 ACX 架構的驅動程式回呼。
ACXDRMFORWARD ACXDRMFORWARD 結構包含DRM系統驅動程式需要的資訊，以便將DRM內容識別碼轉送到處理受保護內容的裝置。
ACXDRMRIGHTS ACXDRMRIGHTS 結構會指定指派給 ACX 音訊釘選或驅動程式數據流物件的 DRM 內容許可權。

列舉

ACX_STREAM_BRIDGE_CONFIG_FLAGS ACX_STREAM_BRIDGE_CONFIG_FLAGS列舉描述 Acx Stream Bridge 組態旗標。
ACX_STREAM_BRIDGE_TYPE ACX_STREAM_BRIDGE_TYPE 列舉描述 Acx Stream 網橋類型。
ACX_STREAM_STATE ACX_STREAM_STATE描述 Acx Stream State 旗標。 此函式位於 acxstreams 標頭中。